> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nocknock.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Choose a Linear Team and Project for New NOCK Issues

> Select which Linear team and project receives new issues from NOCK, set default labels, and update your routing settings at any time.

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

<Steps>
  <Step title="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.
  </Step>

  <Step title="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.

    <Note>
      Every new ticket submitted in NOCK (or forwarded to Linear) will create an issue inside this team until you change the setting.
    </Note>
  </Step>

  <Step title="Save your selection">
    Click **Save** to confirm the team. NOCK will immediately start routing new tickets to that team.
  </Step>
</Steps>

## 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.

<Steps>
  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Save your selection">
    Click **Save**. Future issues created by NOCK will be attached to the chosen project.
  </Step>
</Steps>

<Tip>
  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.
</Tip>

## 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.

<Steps>
  <Step title="Open the Labels field">
    In **Settings → Integrations → Linear**, locate the **Default labels** field below the Project dropdown.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Save">
    Click **Save**. Every issue NOCK creates going forward will include the labels you selected.
  </Step>
</Steps>

<Note>
  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.
</Note>

## 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.

<Warning>
  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.
</Warning>