# Linear

Guide to connect Factory with your Linear workspace

Connect Factory to Linear so Droid can reference Linear project context during development workflows.

## Prerequisites

- Admin access to your Linear workspace
- A Factory account with the **Manager** or **Owner** role

## Integration steps

<Steps>
  <Step title="Access Factory Integrations">
    Log in to your Factory account and navigate to the Integrations section in your Settings.
  </Step>
  <Step title="Initiate Linear Integration">
    Locate and select the Linear integration option.
  </Step>
  <Step title="Authorize Factory's Linear Application">
    You'll be redirected to Linear. Review the requested permissions and click "Authorize" to allow Factory access to your Linear workspace.
  </Step>
  <Step title="Configure Team and Project Access">
    Select the teams and projects you want Factory to interact with. You can adjust these settings later if needed.
  </Step>
  <Step title="Set Up Permissions">
    Ensure that Factory has the necessary permissions to view and create issues, manage workflows, and access relevant project data.
  </Step>
  <Step title="Confirm Integration">
    After granting permissions, you'll be redirected back to Factory. Verify that the integration status shows as "Connected".
  </Step>
  <Step title="Create a New Session">
    Create a new session directly from Linear with this ticket in context by clicking the **Open in Factory** link on the **Factory** attachment that appears on the issue.

    - Note that clicking this link will always create a **new session**.
  </Step>
</Steps>

## Verification

To ensure the integration is working correctly:

1. Create a test issue in one of the authorized Linear projects.
2. Use Factory to interact with this issue (e.g., comment on it or change its status).
3. Verify that the changes are reflected in Linear.

## Best practices

- Regularly review and audit the permissions granted to Factory.
- Use Linear's team-level settings to manage access efficiently.
- Keep your Linear workspace's security settings up-to-date.

## Troubleshooting

<Troubleshooting>
  <TroubleshootingItem title="Linear install is blocked">
    Ensure you have the **Manager** or **Owner** role in Factory and admin rights in Linear.
  </TroubleshootingItem>

  <TroubleshootingItem title="Permission errors appear">
    Check Linear's audit logs for any permission-related issues.
  </TroubleshootingItem>

  <TroubleshootingItem title="Teams or projects are missing">
    Verify that the integration has access to the intended teams and projects.
  </TroubleshootingItem>

  <TroubleshootingItem title="Issue persists">
    Contact Factory support with specific error messages or screenshots.
  </TroubleshootingItem>
</Troubleshooting>

<Card title="Security and Compliance" icon="shield-check" href="https://trust.factory.ai">
  Visit Factory's Trust Center for compliance documents, certifications, and security resources
</Card>

<RelatedLinks>
  <RelatedLink href='/software-factory/triage' title='Triage'>
    Classify and route Linear issues before they go stale.
  </RelatedLink>
  <RelatedLink href='/software-factory/automations' title='Custom Automations'>
    Automate Linear-driven workflows across your team.
  </RelatedLink>
</RelatedLinks>