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
| Field | Description | Example |
|---|---|---|
| Template Name | The name shown in the template picker | Bug Report |
| Template Description | A short explanation of what this template is for | Use this for any confirmed bug with reproduction steps |
| Issue Title | A placeholder title for the new issue | [Bug] Short description of the bug |
| Issue Description | Pre-written body text with placeholders | See example below |
| Label | The label auto-applied to issues from this template | Bug |
| Priority | Default priority for issues from this template | High |
| Assignee | Default 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 Name | Best For | Auto-Applied Label |
|---|---|---|
| Bug Report | Confirmed issues with reproduction steps | Bug |
| Feature Request | New functionality proposals | Feature |
| Performance Issue | Slowdowns, high memory, latency problems | Performance, Bug |
| Security Vulnerability | Security-related findings | Security |
| Weekly Engineering Task | Recurring maintenance tasks | Improvement |
| Documentation Update | Writing or revising team or product docs | Documentation |
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.
