Linear Integration
Connect your Linear workspace to import issues, sync statuses, and manage work from Sunsama.
The Linear integration in Sunsama lets you browse your Linear issues, import them as tasks, keep Linear in sync via automations, and more.
Installation and account management
Adding the Linear integration
There are two ways you can integrate Linear:
- From Integration Settings
- By clicking the Linear icon in the right-hand panel
Click the “Add Linear” button, then grant Sunsama the requested permissions.
Connecting additional workspaces
Sunsama supports integrating multiple Linear user accounts and workspaces.
Navigate to your Linear integration settings and click “Add Linear Account”.
From your Linear integration settings page, you can also remove or reconnect accounts.
Browsing and importing issues
Accessing the Linear integration
To open the Linear panel, click the Linear icon in the right hand navigation panel.
Alternatively, use the Command Palette (CMD+K) to search for “Linear”.
Selecting your Linear account/workspace
If you have multiple connected Linear user accounts and/or workspaces, you can select the one you want to view issues from by clicking on the icon in the top-right corner of the panel.
Browsing Linear views and issues
My issues view
The only built-in view available in the Linear integration is your “My issues” view.
Click on the dropdown filter selection button under “My issues” to view:
- Issues assigned to you in Linear
- Issues you created in Linear
- Issues you are subscribed to in Linear
Issues are sorted by their creation date, and completed issues show for five days after completion in the “My issues” view.
Any other filtering, grouping, or ordering you can apply to your view of “My issues” in Linear is not currently supported in Sunsama. To display or filter your issues in any other way, a custom view in Linear is required.
Custom views
Linear custom views are useful as they can display the specific set of issues you wish to see via filters you set up in Linear. Your Linear custom views can be browsed and imported from in Sunsama.
Like the “My issues” view, it is not possible to control the sorting or ordering of the issues in your custom views within Sunsama; issues are sorted by their creation date.
Filter by already imported
Use this filter setting to show or hide issues from the integration panel that you have already imported into Sunsama.
Importing issues
When you are ready to import a certain issue from Linear, you can pull it into your plan in Sunsama. There are three ways to do this via the in-app integration:
- Drag and drop the task from the Linear panel into your Sunsama task list.
- To timebox the task directly, switch to calendar view (keyboard shortcut
Tab) and drag and drop the Linear issue directly onto your Sunsama calendar at the time you plan to work on it. This will add the task to that day in Sunsama and create a working session on your calendar. - Click on the issue in the Linear panel and click “Add to today” or select a specific date for the task.
Add via URL
If you’re struggling to find your issue in the integration panel for whatever reason, or you’re already viewing your issues within Linear directly, you can always import an issue into Sunsama from Linear using the add via URL method.
Simply copy the URL for an issue in Linear, and paste it into a new task modal within Sunsama or with the global add task modal if using the Sunsama desktop app.
Interacting with imported issues
Once a Linear issue is imported into Sunsama, it becomes a Sunsama task, with an embedded Linear issue. This section explains how data flows between Linear and Sunsama and where you should do your work.
Imported issues
Once a Linear issue is imported into Sunsama, it becomes a Sunsama task, with an embedded Linear issue. You can tell which tasks are imported from Linear via the Linear icon on the card. Clicking on this icon will bring you to the issue in Linear.
Viewing Linear issue details
Click on a Sunsama task that’s linked to Linear to see a preview of your Linear issue embedded inside the Sunsama task.
Interacting with Sunsama specific task information
Your associated Sunsama task acts like a worksheet for your Linear issue. Inside your Sunsama task, you can add notes, time tracking information, subtasks, and comments without messing with your Linear issue. Use your Sunsama task to track the minutia of the task that your collaborators might not care about inside of Linear.
Completing a task
When you complete a Linear issue in Sunsama, you can have Sunsama show a prompt to automatically update the status of the task back in Linear. This is explained in Keep Linear in sync via automations.
Keep Linear in sync via automations
Linear Automations enable control over how issues in Linear are updated when taking actions inside Sunsama, such as importing or completing tasks.
Import automations
Show prompt to update status in Linear: If toggled on, Sunsama will ask you to update the Linear issue’s “status” right after you import the task. This is useful for making sure issues move along from “To do” to “Doing” statuses, for example.
Completion automations
Show prompt to update status in Linear: If toggled on, Sunsama will ask you to update the Linear issue’s “status” as soon as you mark it complete. This is useful for making sure issues move along from “Doing” to “Done” statuses.
Updating Linear issue status when adding via URL
You can also update the Linear issue status when using the URL import method. Paste a Linear issue URL and select it to update the status before adding the task.