Skip to main content
Linear logo

​
Overview

Build customer-driven roadmaps by creating tickets from and linking customer feedback to projects in Linear. Our Linear integration works across themes and data in Channels as well as docs and highlights in Projects so you can act on what you learn from customers.

​
Set up Linear integration

Anyone with any level of user access to Linear and OCSEE can connect to OCSEE by navigating to the Settings page in OCSEE.
  • To connect your Linear account, select ⚙️ Settings → Integrations, locate Linear and click •••.
  • Next, select Connect and continue to login to your Linear account, review requested permissions, and authorize the connection.
  • Once connected, you will be able to create and link OCSEE content to Linear issues and projects.

​
Create a Linear issue

Create a Linear issue or project directly from customer feedback in Channels or Projects.
  • To do this, navigate to a theme or data point within a channel and click the ••• menu .
  • Next, click Send to Linear then Create new issue.
  • From there, complete details that you want to appear in Linear. When creating a project, you must select a team and enter a issue name. Optional fields include a description for the issue, a label, state, priority, assignee, project, and customer.

​
Create a Linear project

Create a Linear project directly from customer feedback in Channels or Projects.
  • To do this, navigate to a theme or data point within a channel and click the ••• menu .
  • Next, click Send to Linear then Create new project.
  • From there, complete details that you want to appear in Linear. When creating a project, you must select a team and enter a project title. Optional fields include a description for the project, a label, and customer.

​
Link OCSEE content to Linear

You can link Channels themes, Channels data points, Project highlights, and docs to Linear. When linking, these items are attached to Linear issues or projects as embedded objects.
  • To do this, navigate to a theme, data point, highlight, or doc and click the ••• menu .
  • Next, click Send to Linear and select one of the following options:
    • Link to existing issue: Search for an existing Linear issue and link the OCSEE item to it.
    • Link as a customer request to existing project: Search for an existing Linear project and add the OCSEE item as a customer request.

​
View OCSEE content in Linear

Once a doc, theme, or highlight from OCSEE is linked, it will appear as an interactive embed within the Linear issue or project. The embed shows a preview of the content from OCSEE and includes a direct link back to the original item for full context.
While only authenticated users can link or create items from OCSEE, the resulting embeds are visible to all users in Linear, and the link status is visible to all users in OCSEE.

​
Disconnect your Linear account

When you disconnect OCSEE, we will no longer have access to your Linear data or your Linear account information. Any files that you have imported into OCSEE before disconnecting will not be deleted and will remain in OCSEE.
  • If you wish to disconnect Linear account from OCSEE, select ⚙️ Settings → Integrations , locate Linear, click •••and select Disconnect.

​
Requested permissions

The Linear integration uses an OAuth app that requires the following scopes:
  • read – Allows the integration to read data from your Linear workspace.
  • write – Allows the integration to update existing records.
  • issues:create – Lets the integration create new issues in Linear.
  • comments:create – Lets the integration add comments to issues.
These permissions enable OCSEE to sync data, create issues, and add comments automatically, ensuring a smooth workflow between Linear and OCSEE. With these scopes, the integration can access Linear workspace data that the installing user has permission to see.