Linear Integration

Connect your Linear workspace to deprec8 to create issues for deprecation milestones directly from the deprecation detail page.

Requirements

• PRO plan or higher
• A team organization in deprec8
• Admin role in the organization
• A Linear workspace you have access to

Connecting Linear

1. Switch to your organization using the organization switcher in the navigation bar
2. Go to Settings → Integrations
3. In the Linear card, click Connect Linear
4. You'll be redirected to Linear to authorize deprec8
5. Grant the requested permissions and click Allow
6. You'll be redirected back to deprec8 — the Linear card now shows as connected

Configuring Defaults

After connecting, configure default values for new issues:

1. Go to Settings → Integrations
2. In the Linear card, click Configure
3. Set your defaults:
   • Default Team — the Linear team where issues are created (required for test issues)
   • Default Priority — priority level for new issues (can be overridden per-deprecation)
   • Default Labels — labels to apply to all created issues
4. Click Save Configuration

Testing the Connection

After configuring a default team, you can verify everything works:

1. Go to Settings → Integrations
2. In the Linear card, click Send Test Issue
3. A test issue is created in your default team
4. Check your Linear workspace to confirm the issue appeared

A default team must be configured before sending a test issue.

Creating Issues from Deprecations

Once Linear is connected, a Push to Linear button appears on deprecation milestone detail pages:

1. Navigate to a deprecation milestone
2. Click Push to Linear
3. An issue is created in Linear with the deprecation details

The created issue includes:

• Deprecation title and description
• Affected component and category
• Milestone date and status
• A link back to the deprecation in deprec8

Priority Mapping

When creating issues, deprec8 maps the deprecation status to a Linear priority:

Duplicate Prevention

deprec8 tracks which deprecation milestones have already been pushed to Linear. If a milestone has already been pushed:

• The Push to Linear button shows the existing Linear issue identifier instead
• Clicking it opens the existing issue in Linear
• This prevents duplicate issues from being created

Roles and Permissions

Disconnecting

To remove the Linear integration:

1. Go to Settings → Integrations
2. In the Linear card, click Disconnect
3. Confirm the disconnection

Disconnecting removes the OAuth connection and configuration from deprec8. Any issues already created in Linear are unaffected.

Troubleshooting

"Push to Linear" button not visible

• Confirm your organization has Linear connected (check Settings → Integrations)
• Ensure you're viewing the deprecation in the correct organization context

Test issue fails

• Verify a default team is configured
• Check that the connected Linear user still has access to the selected team
• Try disconnecting and reconnecting Linear

Authorization expired

Linear tokens may expire if permissions are revoked in Linear. Disconnect and reconnect the integration to obtain a fresh token.