RoadmapAI
Sign in Start free trial
Setup guide · ~2 minutes

How to connect Linear to RoadmapAI

Connect your Linear workspace to turn new issues in your feedback teams into requests, comment back as they move, and ship roadmap items when their issues are done.

Before you start
  • ✓A RoadmapAI project (the free trial works)
  • ✓Admin access to the Linear workspace (to authorize an app)

Step by step

  1. 1

    Open Integrations in your dashboard

    In RoadmapAI, open Integrations from the sidebar and find the Linear section.

  2. 2

    Click "Connect Linear"

    Linear asks you to authorize RoadmapAI for your workspace. Check the workspace name at the top and click "Authorize".

  3. 3

    Pick the teams to read

    Back in RoadmapAI, Configure opens. Under "Teams to read", tick the teams your customers or support staff file into, such as a Feedback or Triage team.

    Tip: Avoid engineering teams full of internal tasks. If you have to read them, use a label filter.

  4. 4

    Filter by label (optional)

    Add labels like "Feature request" under "Only issues labeled" to read only those issues. An issue that gets the label later is read then.

  5. 5

    Keep issues and the roadmap in step

    Two switches keep both sides in sync:

    • •"Ship the item when the issue is done": moving an issue to a completed state moves its item to Completed. Canceled issues are left alone
    • •"Complete the issue when the item ships": when the item reaches Completed, its issues move to their team's Done state
  6. 6

    Set up comments and save

    Choose when RoadmapAI comments on the issue (as the RoadmapAI app). Add engineers under "Ignored users" by their Linear name. Click "Save settings".

Use cases

Support files customer asks into Linear

Your support team logs what customers ask for in a Feedback team. RoadmapAI turns each issue into a request and merges duplicates.

What happens Issue in Feedback: "Acme wants bulk user import"
What RoadmapAI does Captured as "Bulk user import", or counted as a vote if it is already on the roadmap.

Engineering ships, the roadmap updates itself

When engineers close the issue, the public roadmap item moves to Completed and everyone who asked is told.

What happens The Linear issue moves to Done.
What RoadmapAI does The roadmap item "Bulk user import" moves to Completed.

Troubleshooting

No teams are listed

The app can only see teams you have access to. Ask a workspace admin to connect it, or join the team in Linear.

The workspace shows "Disconnected"

The app's access was revoked in Linear. Click "Reconnect" and authorize it again.

Start free trial → About the Linear integration
Other setup guides
Discord Slack GitHub Intercom Email