Linear Templates

Templates in Linear let you pre-fill issue content so the same information doesn't have to be written from scratch every time. When your team creates the same type of issue repeatedly — bug reports, feature requests, weekly tasks — templates enforce consistency and save time.

What a Template Does

A template stores a pre-written title, description, label, assignee, priority, and other properties. When someone creates a new issue from a template, all stored fields populate automatically. The person creating the issue fills in the parts specific to their situation and submits.

Without Template                  With Template
──────────────────                ──────────────────
Open new issue                    Open new issue
      │                                 │
      │                         Choose "Bug Report" template
      │                                 │
Type everything manually          Fields auto-populated:
- Title from scratch              ✅ Title: "[Bug] Describe here"
- Description from scratch        ✅ Description: Steps/Expected/Actual
- Set priority manually           ✅ Priority: High
- Choose label manually           ✅ Label: Bug
- Assign manually                 ✅ Assignee: QA Team
      │                                 │
Takes 3-5 minutes                 Takes 30 seconds

Create an Issue Template

Go to Settings > Teams > [Team Name] > Templates and click New Template.

Template Fields

FieldDescriptionExample
Template NameThe name shown in the template pickerBug Report
Template DescriptionA short explanation of what this template is forUse this for any confirmed bug with reproduction steps
Issue TitleA placeholder title for the new issue[Bug] Short description of the bug
Issue DescriptionPre-written body text with placeholdersSee example below
LabelThe label auto-applied to issues from this templateBug
PriorityDefault priority for issues from this templateHigh
AssigneeDefault assignee (optional)Leave blank for reporter to choose

Writing a Good Template Description

The description body of a template guides the person filling it in. Use clear section headers and placeholder prompts in brackets.

Bug Report Template Description

## What is the bug?
[One sentence describing what is broken]

## Steps to Reproduce
1. [First step]
2. [Second step]
3. [Additional steps if needed]

## Expected Behavior
[What should have happened]

## Actual Behavior
[What happened instead]

## Environment
- Browser / OS: [e.g. Chrome 124, macOS 14]
- App version: [e.g. v2.4.1]
- User account type: [e.g. Free / Pro]

## Screenshots or Logs
[Attach if available]

Feature Request Template Description

## What problem does this solve?
[Describe the user pain point or business need]

## Proposed Solution
[Describe the feature you want built]

## Who benefits from this?
[Which users or teams are affected]

## Acceptance Criteria
- [ ] [Condition 1 that must be true for this to be Done]
- [ ] [Condition 2]
- [ ] [Condition 3]

## Related Issues or Designs
[Links to Figma, related issues, or documentation]

Commonly Used Template Types

Template NameBest ForAuto-Applied Label
Bug ReportConfirmed issues with reproduction stepsBug
Feature RequestNew functionality proposalsFeature
Performance IssueSlowdowns, high memory, latency problemsPerformance, Bug
Security VulnerabilitySecurity-related findingsSecurity
Weekly Engineering TaskRecurring maintenance tasksImprovement
Documentation UpdateWriting or revising team or product docsDocumentation

Use a Template When Creating an Issue

Press C to open the new issue panel. Click Templates in the bottom bar of the panel. Select the template you want. All pre-filled fields load instantly. Edit the placeholder text with the specific details and submit the issue.

Project Templates

Templates also work at the project level. A project template pre-creates a set of issues that every new project of that type should include. For example, a "Website Launch" project template auto-creates issues for design review, content writing, QA testing, and deployment planning.

Find project templates in Settings > Teams > [Team] > Templates > Project Templates. Click New Project Template and add the standard issues each project of that type needs from day one.

Leave a Comment

Your email address will not be published. Required fields are marked *