Debugging

We share some debugging tips for common issues below. Please reach out to us when you hit an issue, but the steps below may help you resolve it faster than we can reply.

An icon representing Debugging

Try removing and then reinstalling the integration from settings. This is the first thing we'll ask you to do if you write in, so it's worth trying before you do.

  • We recommend doing this from the web browser, not desktop client
  • After removing and before reinstalling, go to https://linear.app/reset to reset the local database. You may also want to check the integration application after removal to make sure Linear is showing as removed from their end.

If you can't get an integration to work even after reinstalling it, please reach out.

Please check that you aren't hitting the following limitations:

  • You can only connect your GitHub account to a single Linear workspace. If you want to connect your GitHub org to a second workspace, ask someone else from your org to set up the integration through their GitHub account.
  • You can only connect one Github org to a single workspace (there are no workarounds at this time). These are limits of GitHub apps.

If it should be working but isn't, then try disabling then re-enabling the integration. From the web browser, disconnect the integration from GitHub under Settings > Workspace > Integrations > GitHub. Once you have, reset the local database with https://linear.app/reset and then go through the integration set up again.

We recommend connecting the Figma integration from a web browser. If previews stop working, first check that the Figma integration is still connected. If you hit an error in the macOS or Windows app where previews don't work there but you can get it to work in a browser, try clearing the local data and disconnecting then reconnecting to Figma. Specifically:

  • From the web browser, disconnect the Figma integration.
  • Go to the app and clear application data (from the menu bar).
  • From the browser, reconnect Figma.

We may ask you to take these steps to help us debug or resolve your issues.

In Linear, press Cmd/Ctrl K to open the command menu and type Developer logging and select the entry Developer: Turn logging on.

  1. Then open the Developer Tools view in your app or browser. Go to the menubar at the top of your screen, then View > Developer tools. In macOS, Option Cmd I opens it and in Windows Ctrl Shift I does.
  2. Then take the action again and screenshot or record any errors.

If it looks like your data may have gotten out of sync, you can try logging out and then back in or resetting the database. Be sure not to do this if you have unsaved issue drafts or issues waiting to sync from offline mode, since either action will delete local storage.

To reset the local database, on desktop, open the command line with Cmd/Ctrl K and search for Developer: Reset local database and then take that action. From the browser you can go to http://linear.app/reset and it'll do the same thing.