# Linear

Open a Linear issue from each submission, in the team you pick. Write the title and description yourself, insert answers with @, and copy past submissions in.

## What you get

- One Linear issue per submission, created in your name
- Title and description templates. Type **@** to insert a field value.
- Markdown in the description: bold, lists, headings, code blocks, quotes, and links
- An optional project for every issue
- Past submissions copied in when you connect

## Connect Linear

1. **Open Integrations**

   Click Integrations in the form's top bar, then pick Linear. Click **Connect Linear workspace**, or pick an account the workspace already connected.

2. **Workspace and team**

   Issues go to this team. Each integration uses one team. Add another integration for a second team.

3. **Issue**

   Pick a project for every issue, if you like; it resets when you change the team. Then write the title and description: type @ to insert field values or submission metadata such as PDF Link. The title is plain text, up to 255 characters. The description is markdown.

4. **Unfinished drafts (optional)**

   Under **More options**, on Pro and Business, pick an idle window and write a title and description for unfinished drafts. Leave it Off to skip.

5. **Turn it on**

   Click **Turn on Linear**, then **Send test** to create a real issue with a \[Test] prefix in the team. Archive or delete it afterwards.

## Backfill existing submissions

When you connect, you can copy past submissions in as Linear issues. Formstep creates them in the background, about one per second.

## Unfinished drafts

On Pro and Business, Linear can also create a separate issue for [unfinished drafts](https://formstep.io/docs/submissions-analytics/partial-submissions/#unfinished-drafts) from the share link, set under **More options** › **Unfinished drafts**. These issues get a `partial-submission` label.

## Limits and behavior

- One new issue per submission. Formstep does not comment on existing issues.

- Formstep cuts a title longer than 255 characters and adds an ellipsis.

- An empty title becomes `New submission to <form name>`.

- A file upload answer shows the file name and its download link.

- A [repeating group](https://formstep.io/docs/building-forms/repeating-groups/) inserted with @ shows every item, joined by “ · “.

## When something goes wrong

If you revoke Formstep’s access in Linear, the integration shows **Connection expired**: click **Reconnect**. For retries and pausing, see [Health and monitoring](https://formstep.io/docs/integrations/health-monitoring/).

## FAQ

**What access does Formstep need?**

Access to read your teams, projects and labels, and to create and update issues. Issues are created in your name.

**Can I change the team or project after setup?**

Yes. Open Integrations, pick Linear under **On this form**, change either field, and click Save. Changing the team resets the project, because projects belong to a team.

**Can I connect multiple Linear workspaces?**

Yes. The workspace owner connects each Linear account. Each integration picks one.

**Can other workspace members see my Linear connection?**

Yes. Linear connections belong to the workspace. Any member can use any connected Linear account in an integration.

**How do I remove the integration?**

Open Integrations, pick Linear under **On this form**, and choose **Delete integration** in the ⋯ menu. New submissions stop creating issues at once. To also revoke Formstep’s access, do it in your Linear user settings.

## Next steps

[GitHub Issues](https://formstep.io/docs/integrations/github/) — Turn each submission into a GitHub issue

[Health and monitoring](https://formstep.io/docs/integrations/health-monitoring/) — Retries, pausing and reconnecting