To get data from Linear into Korl, start by authenticating Linear (under Settings, then Integrations). If you have access to more than one Linear workspace, ensure that you select the desired workspace from the upper left corner when authorizing the integration with Korl.

‍

Next, go to Settings, then Project Attributes to configure the Korl attributes that you want to sync from Linear. For each attribute that should sync from Linear, set the data source to Linear and then specify the Linear field to sync.

‍

💡 Tip: You’ll be able to configure different fields for Linear projects versus issues (since Linear supports different fields for each). If you set Linear as the data source and don’t have a mapped field for either projects or issues, Korl will attempt to sync the field you’ve defined for the other type. If that field doesn’t exist (e.g. issues can have attachments in Linear, but projects cannot), Korl will simply note that the synced field doesn’t exist for the Dev link provided.

‍

Now you are ready to import issues or projects from Linear.

‍

If you want to import Linear issues, the best way to do this is to export a saved view from Linear to a .csv, then upload that .csv to Korl.

‍

1. In Linear, create a “Saved view” of the issues you want to import into Korl.
2. From the view’s 3-dot menu, select “Export issues as CSV…”

‍

1. Open the CSV in Excel or Google Sheets.
2. Add a column called “Dev link” that uses the concatenate function to add the unique URL for your Linear workspace (e.g. “linear.app/workspace/issue/”) with the “ID” for the issue to import.

1. Download the Google Sheet as a .csv file.
2. Go into the Roadmap tab in Korl and “Add from .csv file”  (under the + button).
3. Follow the steps to upload the file and map columns in your .csv to the relevant Korl attributes. Ensure that you map the “Dev link” attribute in Korl to the “Dev link” column you just created in the Google Sheet that has the actual URL to the relevant Linear issue.

‍

‍

Once you import the .csv, Korl will not only create a roadmap item for each row in the .csv file, but it will also automatically sync data from Linear for the Korl attributes you configured to source from Linear.

If you want to import Linear projects, you will have to add each project’s URL directly as the Dev link for a project in Korl. This is because when exporting projects, Linear does not include the project ID, which means you cannot easily derive the URL from the exported data.

You can either export Linear projects, upload them as a .csv, and then add the Linear URL as the Dev link for each Korl project. Or you can simply add projects manually in Korl and then add the Linear project link, and all attributes configured to source from Linear will get synced.

‍

‍💡 Tip: The fastest way to add Dev links for multiple items in Korl is from the Roadmap table, which supports inline editing (as well as hiding and showing columns for a more focused view).‍