Overview

Export task breakdowns from Projan plans as Linear issues with proper labels, descriptions, and parent-child relationships. Issues are created with full context including acceptance criteria and priority.

Prerequisites

• Linear workspace
• Team access in the target workspace
• Projan team admin or individual account

Setup Steps

1. Go to Settings > Integrations > Linear
2. Click “Connect Linear”
3. Authorize the connection
4. Select a default team (optional)

Permissions Requested

Scope	Purpose	Access Level
read	Read teams, projects, labels	Read
write	Create and update issues	Write
issues:create	Create new issues	Write

What Data is Accessed

• Team names and IDs
• Project list
• Labels
• Existing issues (for parent linking)

Data Storage

• Encrypted access and refresh tokens (24-hour expiry, auto-refresh)
• Organization name

Category Mapping

Projan Category	Linear Mapping
Epic	Epic label
Feature	Feature label
Story	Story label
Task	Task (default)
Subtask	Task with parentId
Bug	Bug label
Spike	Spike label
Milestone	Milestone label

Disconnecting

Go to Settings > Integrations > Linear > Disconnect.

Token is purged immediately. Also revoke from Linear: Settings > Authorized Applications > Projan.

Troubleshooting

Issues not appearing

• Check that the correct team is selected during export
• Verify your Linear account has issue creation permissions

Labels missing

• Projan creates labels automatically on first export
• If label creation fails, check workspace admin permissions

Rate limits

• Batch exports may take a moment due to Linear’s API rate limits
• Exports are queued and retried automatically