Skip to content

Connect Linear

Your organization sends the issues Studio creates for slices to Linear by letting Studio’s own Linear app work in your workspace. No personal API key is kept, and issues are created by the app rather than by the person who connected it.

You are a maintainer of the organization and can authorize apps in the Linear workspace.

  1. Open Organization settings and select Integrations.

  2. Under Other providers, select Connect Linear.

  3. Linear asks you to allow Studio’s app on a workspace. Allow it.

  4. Linear sends you back to the Integrations page, which says Linear is connected. The workspace is listed under its own name.

Select Connect another Linear to connect another workspace.

If Linear shows Not configured by the Studio operator, Studio’s Linear app is not set up for this Studio and nothing can be connected yet. Contact support (see Get help).

Organization settings, Integrations, Other providers: Linear, with GitLab, Azure DevOps and Jira, reads Not configured by the Studio operator
Linear is the last entry under Other providers. When it reads Not configured by the Studio operator, there is no Connect Linear button.

When your organization has never chosen where issues go, the workspace becomes the place. Otherwise Issues keeps its choice and the workspace is offered there. See Connect integrations.

Each workspace shows whether it is ready: it is while Studio’s app can still reach it. If the app was removed in Linear, the workspace shows the reason and asks you to connect Linear again.

Studio asks for read and write access, so it can find a team by its key, create issues and move them between states. Its tokens are encrypted with your organization’s own key and are only decrypted at the moment they are handed to Linear.

Select Remove next to the workspace. A workspace chosen for issues has to be replaced there first. Removing it does not uninstall Studio’s app; do that in Linear’s own settings for applications.