# Linear

> Adjust your preferences to help you move faster and personalize your workflow.

## Pages

- [Preferences](account-preferences.md): Adjust your preferences to help you move faster and personalize your workflow.
- [Advanced usage](advanced-usage.md): The Linear Client wraps the [Linear SDK](https://github.com/linear/linear/tree/master/packages/sdk/src/_generated_sdk...
- [Interaction Best Practices](agent-best-practices.md): Linear users have high expectations for the quality and consistency of the experience inside Linear. We aim to extend...
- [Developing the Agent Interaction](agent-interaction.md): Once your agent is installed and authenticated, it can begin participating in workflows inside Linear. Agents become ...
- [Signals](agent-signals.md): Signals are optional metadata that modify how an [Agent Activity](https://linear.app/developers/agent-interaction#age...
- [AI Agents](agents-in-linear.md): Build and deploy AI agents that work alongside your team
- [Getting Started](agents.md): This guide describes how to best integrate an AI agent into Linear. It includes implementation guidelines on how to d...
- [Agent Interaction Guidelines (AIG)](aig.md): Agents are changing how software is planned, built, reviewed, and deployed. Because agents produce work in abundance,...
- [Airbyte](airbyte.md): [!NOTE]
- [API and Webhooks](api-and-webhooks.md): Linear's GraphQL API and webhooks lets you extend Linear's functionality beyond what we provide out of the box.
- [Assign and delegate issues](assigning-issues.md): Issues in Linear are assigned to a single person at a time, giving teams clear ownership and responsibility. Assignme...
- [Attachments](attachments.md): Issue attachments allow you to link external resources to issues and display them inside Linear similarly to GitHub P...
- [Audit log](audit-log.md): Audit logs show you a record of workspace events over the last 90 days.
- [Billing and plans](billing-and-plans.md): We offer a free plan and different paid plans to suit your needs.
- [Board layout](board-layout.md): Nearly all views in Linear can be shown in board layout in addition to list view.
- [Comments and reactions](comment-on-issues.md): Leave comments or reactions on issues.
- [Concepts](conceptual-model.md): Gain a basic understanding of Linear's design so you can set up your workspace and navigate efficiently.
- [Issue status](configuring-workflows.md): Set statuses that your issues will move through on each team.
- [Create issues using linear.new](create-issues-using-linear-new.md): You can open Linear using a link with specific query parameters to start issue creation and pre-fill fields. This is ...
- [Create issues](creating-issues.md): Creating issues is the most common action taken in Linear.
- [Custom Views](custom-views.md): Create durable filtered views of issues, projects, or initiatives that you can save and share with others in your wor...
- [Customer Requests](customer-requests.md): Bring the voice of the customer into product development.
- [Cycle graph](cycle-graph.md): The graph displays the progress you've made in your cycle.
- [Dashboards](dashboards.md): Dashboards let you bring together insights from across teams and projects onto a single page. Use them to track key m...
- [Team pages](default-team-pages.md): Linear teams contain default views to organize issues and projects.
- [Delete and archive issues](delete-archive-issues.md): Linear archives issues automatically to keep your workspace uncluttered and easy to search.
- [Deprecations](deprecations.md): Linear's GraphQL API doesn’t have versioning like many REST APIs due to the more constantly evolving nature of GraphQL.
- [Discord](discord.md): Combine Linear with Discord keep everyone in sync.
- [Display options](display-options.md): Display options let you group and order issues and projects to determine which information appears in your view.
- [Due dates](due-dates.md): Add due dates to issues to help your team keep track of time-sensitive work.
- [Edit issues](editing-issues.md): Making changes to an issue.
- [Editor](editor.md): Formatting description fields.
- [Estimates](estimates.md): Show how much effort each issue will take.
- [Exporting Data](exporting-data.md): Export your workspace data using built-in tools, integrations, or the API
- [Favorites](favorites.md): Favorite views you frequently use.
- [Figma](figma.md): We use Figma at Linear and our integrated tools make it easy for you to collaborate on design.
- [File storage authentication](file-storage-authentication.md): Files uploaded to Linear, such as images and attachments, are stored in Linear's private cloud storage. You must auth...
- [Filtering](filtering.md): Most results that are paginated can also be filtered. This makes it easy to retrieve specific information, like any i...
- [Filters](filters.md): Filters allow you to refine existing views and create custom views to show only the relevant issues.
- [Front](front.md): Our Front integration makes it easier for you and your team to keep track of bugs and feature requests and interact w...
- [Download Linear](get-the-app.md): Linear is available on browsers, macOS, Windows, iOS and Android.
- [GitHub](github-integration.md)
- [GitLab](gitlab.md): Linear supports linking your Linear issues to GitLab and automates your merge request workflows.
- [Gong](gong.md): Automatically create issues from Gong call recordings.
- [Google Sheets](google-sheets.md): Use the Google Sheets integration to create custom analytics and dashboards for your company.
- [Getting started](graphql.md): Linear's public API is built using GraphQL. It's the same API we use internally for developing our applications. If y...
- [How to upload a file to Linear](how-to-upload-a-file-to-linear.md): This guide shows you how to upload a file to Linear while using the [GraphQL API](https://linear.app/developers/graph...
- [Importer](import-issues.md): Learn best practices for importing to Linear. Select the tool you're importing from in the table of contents for spec...
- [Inbox](inbox.md): The Inbox is your notification center in Linear and where you’ll find important updates on issues in your workspace.
- [Initiative and Project updates](initiative-and-project-updates.md): Keep teams and leaders aligned with structured updates on the health and progress of Initiatives and Projects, availa...
- [Initiatives](initiatives.md): Use initiatives to group projects by company objective to align on your organization's goals and track progress towar...
- [Insights](insights.md): Real-time analytics for all your Linear data. Visualize issue data to spot trends and remove blockers.
- [Integration Directory](integration-directory.md): Discover Linear add-ons or build your own
- [Intercom](intercom.md): Our Intercom integration makes easy to keep track of bugs and feature requests and interact with the customers who re...
- [Invite members](invite-members.md): Invite and manage members of your workspace.
- [Issue documents](issue-documents.md): Create documents for issues.
- [Issue relations](issue-relations.md): Create relationships between issues such as blocking, related, and duplicate.
- [Issue templates](issue-templates.md): Templates speed up issue creation, ensure properties are applied when necessary, and facilitate reporting.
- [Jira](jira.md): Enable Jira Sync while trialing or transitioning to Linear to keep Jira spaces up to date.
- [Label views](label-views.md): Label views show all issues under a specific label or label group.
- [Labels](labels.md): Use labels to categorize issues.
- [Asks](linear-asks.md): Asks turns requests like bug reports, questions, and IT needs into actionable issues in Linear.
- [Login methods](login-methods.md): We offer multiple ways to log in and options to restrict login methods for added security.
- [Managing Customers](managing-customers.md): The Customers requests feature allows you to manage customers and requests inside of Linear.
- [MCP server](mcp.md): The Model Context Protocol (MCP) server provides a standardized interface that allows any compatible AI model or agen...
- [Members and roles](members-roles.md): Linear provides several role types to help you control access and permissions across your workspace. Each role gives ...
- [Migrating from 1.x to 2.x](migrating-from-1-x-to-2-x.md): Version 2 of the SDK introduces a new naming pattern for mutations. The action verb (create, update, delete, archive)...
- [My issues](my-issues.md): See your most important issues in one view.
- [Notifications](notifications.md): Receive alerts on important updates in the Linear desktop app, mobile app, Slack, or email.
- [Notion](notion.md): Preview Linear issues directly from Notion
- [OAuth 2.0 authentication](oauth-2-0-authentication.md): Linear supports OAuth2 authentication, which is recommended if you’re building applications to integrate with Linear.
- [OAuth actor authorization](oauth-actor-authorization.md): By default all Linear’s API authentication methods treat the authenticating user as the API actor. This means that ac...
- [Pagination](pagination.md): All list responses from queries return paginated results. We implement Relay style cursor-based pagination model with...
- [Parent and sub-issues](parent-and-sub-issues.md): Use sub-issues to break down larger "parent" issues into smaller pieces of work.
- [Peek preview](peek.md): View issue details without having to open issues.
- [Priority](priority.md): Set issue priority to indicate which issues to complete first.
- [Private teams](private-teams.md): Create private teams for issues that should only be accessed by certain workspace members.
- [Profile](profile.md): Your profile found in [Settings > Account > Profile](https://linear.app/settings/account/profile) is where you person...
- [Project dependencies](project-dependencies.md): Visualize blocked and blocking relationships amongst projects.
- [Project documents](project-documents.md): Create documents for projects.
- [Project graph](project-graph.md): The graph shows you the progress you're making toward completing your project and estimates when you'll complete it.
- [Project labels](project-labels.md): Organize projects with custom labels relevant to your organization's specific context. Filter projects or issues by t...
- [Project milestones](project-milestones.md): Project milestones help you divide and organize work inside projects.
- [Project notifications](project-notifications.md): Set up personal notifications as well as updates that can be shared with the whole company via Slack.
- [Project overview](project-overview.md): The project overview provides a comprehensive summary of the project. It allows you to include both a brief summary a...
- [Project priority](project-priority.md): Set project priority to indicate which projects to complete first.
- [Project status](project-status.md): Project statuses clarify where each project is in its lifecycle
- [Project templates](project-templates.md): Create project templates for repeated projects and their associated milestones and issues.
- [Projects](projects.md): Create Projects for features or large units of work.
- [Pull Request Reviews](pull-request-reviews.md): View and comment on pull request reviews from Linear.
- [Pulse](pulse.md): Pulse keeps you informed about your workspace's project and initiative updates.
- [Rate limiting](rate-limiting.md): Calls to our GraphQL API are rate limited to provide equitable access to the API for everyone and to prevent abuse. W...
- [Salesforce](salesforce.md): Create or link to issues from cases. Linear's Salesforce integration is available as an add-on to our Enterprise plan.
- [SAML](saml-and-access-control.md): Customers can opt to enable SAML for their workspace to manage logins through an Identity Provider.
- [SCIM](scim.md): SCIM, or _System for Cross-domain Identity Management_ allows for the automation of user provisioning for your Linear...
- [Errors](sdk-errors.md): Errors can be caught and inspected by wrapping the operation in a try catch block:
- [Fetching & modifying data](sdk-fetching-and-modifying-data.md): Some models can be fetched from the Linear Client without any arguments:
- [Webhooks](sdk-webhooks.md): The SDK provides a helper class to help you start listening to Linear [webhook events](https://linear.app/developers/...
- [Getting started](sdk.md): The Linear Typescript SDK exposes the [Linear GraphQL schema](https://github.com/linear/linear/blob/master/packages/s...
- [Search](search.md): Quickly find issues, projects and documents with Search.
- [Security & Access](security-and-access.md): Manage your account security and access.
- [Security](security.md): Learn more about our data security practices and compliance measures.
- [Select issues](select-issues.md): Take actions on groups of issues.
- [Sentry](sentry.md): Our integration with Sentry lets you create Linear issues from Sentry and create links between Linear and Sentry issues.
- [SLAs](sla.md): Automate SLAs for issues that should be completed within a certain amount of time.
- [Slack](slack.md): Combine Linear with Slack to keep everyone in sync.
- [Start Guide](start-guide.md): Linear helps teams plan, track, and deliver work without a lot of overhead. This guide gets you from “new workspace” ...
- [Sub-initiatives](sub-initiatives.md): Sub-initiatives allow Initiatives to be nested inside one another, enabling deeper planning and visibility across lar...
- [Sub-teams](sub-teams.md): Group sub-teams underneath a parent team. Feature settings configured in the parent team drive alignment throughout t...
- [Teams](teams.md): Create teams in your workspace to organize different types of work functions.
- [Third-Party App Approvals](third-party-application-approvals.md): Enable third-party application approvals for your workspace to maintain control over which applications can be instal...
- [Timeline](timeline.md): Display projects chronologically to track their progress, deadlines, and dependencies over time
- [Triage Intelligence](triage-intelligence.md): Route issues by using LLMs to infer issue properties and relationships.
- [Triage](triage.md): Manage issues created by other teams and customer support integrations.
- [Update cycles](update-cycles.md): Update your cycles after they have been created
- [Cycles](use-cycles.md): Cycles are a practice to keep up your team's momentum, similar to commonly used agile flavored sprints.
- [User views](user-views.md): See views that show you how work is distributed across your team.
- [Webhooks](webhooks.md): Linear provides **webhooks** which allow you to receive HTTP push notifications whenever data is created, updated or ...
- [Workspaces](workspaces.md): The first step to using Linear is to create a workspace for your team.
- [Zapier](zapier.md): This integration lets you build custom automations to create or update Linear issues when actions are taken on other ...
- [Zendesk](zendesk.md): Our Zendesk integration makes it easier for you and your team to keep track of bugs and feature requests and interact...