Skip to main content
After you connect NOCK to your Linear workspace, you need to tell NOCK exactly where to send new issues. Linear organises work into teams, and optionally into projects within those teams. You can also attach default labels to every issue NOCK creates, which helps your team triage and filter incoming work without any extra manual steps.

​
Select a Linear team

1

Open Linear settings in NOCK

Go to Settings → Integrations → Linear. Your workspace should show a Connected badge. Below it, you will see a Team dropdown.
2

Choose a team

Click the Team dropdown and select the Linear team where you want NOCK to create issues. The list is populated from your connected Linear workspace — only teams your API key’s account is a member of will appear.
Every new ticket submitted in NOCK (or forwarded to Linear) will create an issue inside this team until you change the setting.
3

Save your selection

Click Save to confirm the team. NOCK will immediately start routing new tickets to that team.

​
Optionally select a Linear project

Projects are optional in Linear, and they are optional in NOCK too. If you want issues organised under a specific project within your chosen team, follow these steps.
1

Open the Project dropdown

In Settings → Integrations → Linear, find the Project dropdown below the Team field. It will list all projects currently active in your selected team.
2

Select a project

Pick the project you want new issues assigned to. If you leave this field set to None, issues are created in the team’s backlog without a project assignment.
3

Save your selection

Click Save. Future issues created by NOCK will be attached to the chosen project.
If a project does not appear in the list, check that it is active (not archived) in Linear and that the account whose API key you used is a member of that project’s team.

​
Set default labels

Default labels are automatically applied to every Linear issue NOCK creates. This is useful for marking all incoming feedback issues with a tag like customer-feedback or bug so your team can filter them easily.
1

Open the Labels field

In Settings → Integrations → Linear, locate the Default labels field below the Project dropdown.
2

Choose one or more labels

Click the field and select labels from the list. The list shows all labels defined in your selected Linear team. You can select multiple labels.
3

Save

Click Save. Every issue NOCK creates going forward will include the labels you selected.
Labels are team-specific in Linear. If you change the selected team later, your default label selections will reset — you will need to re-select labels that exist in the new team.

​
Changing your team or project later

You can update your team, project, or default label settings at any time by returning to Settings → Integrations → Linear and making new selections.
Changing the team or project affects only new issues created after you save. Existing Linear issues that were already created by NOCK are not moved — they stay in the team and project they were originally created in.