HomeGuru CommunityProduct TrainingTemplatesSupport PortalDeveloper Network
Guides
Start typing to search…

Setting up Linear as a Source

Connecting Linear as a source in Guru enables teams to sync issues, project updates, and engineering workflows directly into Guru, ensuring that product and development knowledge stays current and easily accessible across teams.

👥

Access Required

Guru Access: You need to be an Admin, Source Creator, or relevant custom role to set up Sources

Linear Access: You need Linear Admin credentials to connect Linear as a source.

Setting Up Linear as a Source

  1. Navigate to Manage > Sources.
  2. Select Linear from the icon menu.
  3. Click Authorize Access and **Use my Credentials (recommended)**and click Next.
  4. Review objects synched and click Next.
  5. Use the Date filter to select the date from which you'd like to sync data. Add additional filters if desired.
  6. Follow the prompts to login to your Linear account and Authorize.
  7. Follow the next and finish prompts to advance and complete the set up.
  8. Once you've finished connecting, you can Add a display name for this Source, followed by Connect.
  9. The next screen will allow you to set Permissions for the source in Guru.

Objects Synced from Linear

Primary objects are the objects used to generate the search record.

Common Model / What You'll See During Setup

Objects/Data Brought In

Key Fields

Ticket

Primary Object: Linear issues

• Name • Description • Status • Priority • Creator • Assignees • Due date • Parent ticket • Ticket URL • Remote created at • Remote updated at • Completed at • Remote ID • Remote data

Comment

Issue comments and threads

• Body • User • Ticket • Remote created at • Remote ID • Remote data

User

Linear workspace users

• Name • Email address • Avatar • Is active • Remote ID • Remote data

Collection

Linear projects and cycles

• Name • Description • Collection URL • Parent collection • Remote created at • Remote updated at • Remote ID • Remote data

Permissions

  • When you connect Linear as a source in Guru, you'll permission that content in Guru. Learn more here.
  • If someone is not provided with access in Guru to this source, they will not see Linear results in searches or when chatting with Guru.

Updated 3 days ago