Beginner
How to create reusable issue templates on Linear
Quick Answer
Create reusable issue templates in Linear by navigating to workspace settings, selecting Templates, and defining structured formats with predefined fields and descriptions. Templates help standardize issue creation across your team and ensure consistent information capture.
Prerequisites
- Active Linear workspace
- Admin or member permissions
- Access to workspace settings
- Understanding of your team's workflow
1
Access workspace settings
Click on your workspace name in the top-left corner of Linear, then select Settings from the dropdown menu. Navigate to the Templates section in the left sidebar under workspace configuration.
Tip
You need admin or member permissions to create templates
2
Create a new template
Click the New Template button in the Templates section. Choose Issue Template from the template type options. Enter a descriptive name for your template in the Template Name field.
Tip
Use clear, specific names like 'Bug Report' or 'Feature Request' to help team members choose the right template
3
Configure template details
Fill in the Title field with a default title format using variables like
[Type] Brief description. Add a detailed description in the Description field with placeholder text, sections, and formatting that guides users on what information to include.Tip
Use markdown formatting to create structured sections like ## Steps to Reproduce or ## Acceptance Criteria
4
Set default field values
Configure default values for fields like Priority, Labels, and Team assignment. Use the dropdown menus to select appropriate defaults that match your workflow. Set the Project and Status if applicable.
Tip
Setting sensible defaults saves time and ensures consistency across issues
5
Add template variables
Use Linear's template variables in your description like
{{user.name}} for the creator's name or {{date}} for current date. Include placeholder sections with ## Section Name and bullet points for required information.Tip
Variables automatically populate when the template is used, reducing manual entry
6
Configure template availability
In the Available to section, choose which teams can access this template. Select specific teams from the dropdown or make it available to all teams in your workspace. Set any restrictions based on user roles if needed.
Tip
Restrict specialized templates to relevant teams to avoid cluttering the template selection
7
Preview and test the template
Click Preview to see how your template will appear when creating an issue. Review the formatting, default values, and placeholder text. Make any necessary adjustments to improve clarity and usability.
Tip
Test the template by creating a draft issue to ensure it works as expected
8
Save and activate the template
Click Save Template to create your reusable template. The template will now appear in the template selection when team members create new issues. You can edit or deactivate templates anytime from the Templates settings page.
Tip
Regularly review and update templates based on team feedback and evolving workflows
Troubleshooting
Template not appearing in issue creation
Check that the template is assigned to the correct team and that you have proper permissions. Refresh your browser and verify the template is saved and active in workspace settings.
Template variables not populating
Ensure you're using the correct variable syntax like
{{user.name}} or {{date}}. Check Linear's documentation for supported variables and verify there are no typos in the variable names.Cannot edit or delete existing template
Verify you have admin or member permissions in the workspace. Template editing may be restricted based on your role. Contact your workspace admin if you need permission changes.
Default field values not applying correctly
Check that the default values you selected are valid for the target team's workflow. Some fields may be team-specific or require certain labels to exist before they can be set as defaults.
Ready to get started with Linear?
Put this tutorial into practice. Visit Linear and follow the steps above.
Visit Linear →