SwitchMigration guide[
] PDF

How to migrate to Linear

Follow this guide for a seamless transition

You’ve made the decision to use Linear as your tool of choice. Now it’s time to get your org onboard.

In this guide, we outline what decisions to make before your Linear migration, the pros and cons of each, and how to best prepare your teams for the shift.

Many teams use the migration to Linear as an opportunity to start fresh and leave their old issues behind. Other teams import their existing issues from other tools for reference or to finish a sprint. Your preference will inform your migration plan.

Import your issues

Use the Importer to pull in-flight issues into Linear and map them to appropriate teams. Linear offers native importers for GitHub Issues, Jira, Asana, Shortcut, and Trello. Alternatively, you can import a CSV with issue data.

Why companies import

Organizations may need to preserve important data from their previous issue tracker, whether for active tasks or future reference. It could also be the case that several teams are working on high-priority projects that are mid-cycle.

Start fresh

Migration is your chance to move forward with intention, not historical baggage. The switch to Linear can be an opportunity for a clean slate.

Why companies start fresh

For an operational reset, get your team members accustomed to Linear terminology and methodology, while keeping them focused on building and shipping. This is opposed to balancing old conventions in imported issues and projects alongside net new issues.

There are two approaches when it comes to setting up Linear.

Standardized workflows

In a prescriptive approach, functions such as technical program management, engineering ops, or IT standardize the Linear workspace and team settings to create a shared way of working. Organizations that follow this path frequently map their backlog and in-progress work to the new way of working in Linear.

The benefits of standardization

Reporting is easier when every team uses the same labels, estimations, templates, statuses, and SLAs. If you know you’re going to need specific reports, for example, it’s worth being intentional about how you structure workflows in Linear.

Standardizing how teams work can also facilitate alignment by establishing a company-wide cadence. Linear cycles get everyone moving at the same speed and shipping on the same timelines.

Autonomous teams

Alternative to a standardized approach, some organizations prefer to give each team autonomy over how they work. Organizations that follow this path typically enable their teams to configure Linear independently.

The benefits of autonomy for teams

Each team can customize their Linear workspace to stay focused and productive. We find that teams that have more freedom in their setup are more likely to fully adopt Linear, though producing reports is not as straightforward when working styles aren’t standardized.

Building an internal transition guide will help you think through each part of the migration and keep everyone on track.

Document the process

Approach

Spell out how you are approaching your migration (standardized vs. autonomous; import vs. starting fresh) and your reasons for doing so.

Since this internal guide will be distributed to teams that did not participate in the pilot, include high-level findings from the trial and state the main goal(s) of switching to Linear. Include a few data points or quotes from real team members to bolster your message.

Timeline

Work with your organization’s leaders to set a go-live date based on your approach to migration and configuration, keeping in mind any renewal dates for the tools Linear is replacing. If the autonomous approach is preferred, we recommend giving teams up to 6 weeks to configure their workspace and team settings.

Training

Run a Linear demo for your organization and share self-serve onboarding resources to teams in advance of the rollout, such as links to Linear docs and best practices. If you plan to use Asks to intake issues from non-Linear users, organize an onboarding session to educate them on how to use Asks in Slack to submit a request.

Communication

Create a Slack channel for Linear-related questions to support your teammates throughout the migration. The Slack channel creates a centralized home for the resources you’re creating, and gives new users a place to ask questions or request support.

Apprehension comes with change. Put your team members at ease by letting them know when Linear is coming and how the migration will work. Keep your announcement short and actionable to increase engagement with the migration.

Use this template as a baseline:

All,

We are moving from prior tool Linear for project and issue tracking this month.

The goal of switching to Linear is to enhance our core issue tracking workflows with an intuitive interface, real-time project updates and seamless integrations with our key tools like list integrations. We are committed to company-wide transparency and believe Linear will offer improved visibility into our projects and tasks.

We are aiming for minimal disruption but expect a transition period as we migrate. If your team is in the middle of a release or needs to delay moving to Linear, please connect with person or team so that we can find an approach that works for your team.

In the coming weeks, we will be working closely with team leads to get you set up on Linear and plan to host training sessions on insert dates to get you up to speed. In the meantime:

  • Read our internal migration guide.
  • Join our Linear-company name Slack channel.

We appreciate your support during this transition. Please don't hesitate to reach out if you have any questions.

Provision users

If you are coming from a prior tool and bringing data over, provision your Linear users. Linear’s native importers will match existing Linear users to the users you are importing. Ideally, users already exist in both services with the same email address and have linked their accounts in Settings > Integrations so that creators, assignees, mentions, and comments are imported properly.

Create your teams

Issues in Linear are organized by team. Linear will automatically create a default team with the same name as your workspace, but you can create more teams to group employees who work together frequently or who work on a specific area or feature. We recommend starting with fewer teams and then adding more (and moving necessary issues) over time.

Import data (if applicable)

Note: You must be a Linear Admin to run an import.

  1. 1.

    Navigate to Settings > Workspace > Import/Export and select your current issue tracker.

  2. 2.

    Select the issues you want to import and the Linear team to import them to.

  3. 3.

    Review fetched data.

  4. 4.

    Map the users the Importer found in your current issue tracker.

  5. 5.

    Confirm your selections. Click Finish.

Migrate your integrations

Most issue trackers are connected to upstream or downstream tools. Work with your Linear admins and those responsible for other internal tools to get each integration up and running. Below are a few examples of common integrations with Linear:

SlackTo create issues and receive notifications
Customer Support ToolsTo intake bugs and feature requests from the frontlines (such as Zendesk, Front, or Intercom)
GitHubLinear’s native workflow automations and issue syncing for OSS.
Triage ResponsibilityCreate ownership over triage; supporting PagerDuty, incident.io and Opsgenie rotations
Google CalendarLet teammates know if you are away or OOO

Sunset your previous tool

Notify your previous service provider that you are no longer using their services once you’ve made the decision to move over to Linear. Work with your internal tools team to shut off access to the tool or put it in read only mode.

Once migrated, send a message to the team Slack channel letting teammates know that your previous issue tracker is no longer available.

Enable users

Follow your training plan and schedule additional enablement sessions as needed. If you’re taking an autonomous approach to configuration, some teams may want extra guidance when configuring workspace and team settings.

Share the Linear Method and Getting Started Documentation in your internal operations documentation for easy reference.

Learn how to hone your Linear pitch or run a pilot to strengthen your case for Linear.

FAQs

Linear offers three pricing tiers (Basic, Business, Enterprise) tailored to the needs of your team. For detailed information about each plan, visit our Pricing page or get in touch with our Sales team.
Yes, we offer white glove onboarding and migration assistance for enterprise customers as well as ongoing priority support and account management. Get in touch with our Sales team to learn more.
If you’re stuck in an annual contract, we'll bridge the gap. Reach out to our team by February 28, 2025 with a copy of your current contract and get Linear for free until your current contract expires, for up to 6 months.
Linear is built with enterprise-grade security practices to keep your work safe and secure at every layer. This includes state-of-the-art encryption, safe and reliable infrastructure partners, and independently verified security controls. Linear is SOC2 and HIPAA compliant and committed to compliance with Europe’s General Data Protection Regulation (GDPR). You can learn more about Linear’s security features here.
Linear is natively integrated with all major tools that teams use in their day-to-day workflows, ranging from engineering (GitHub, GitLab,Sentry) and design tools (Figma) to customer support systems (Intercom, Front, Zendesk) and communication platforms (Slack, Discord).

Additionally, there are hundreds of third-party integrations. You can also build your own apps and integrations with the Linear API.