Linear

What you get

• One Linear issue per submission, attributed to the connecting user

• Title and description built from a template editor — type @ to insert any form field value

• Description supports markdown (bold, lists, headings, code fences, block quotes, links)
• Optional default project applied to every issue
• Backfill existing submissions on demand (~1 issue per second)

• Test button that creates a real [Test]-prefixed issue so you can verify before going live

Connect Linear

1. 1

   Open Form settings → Integrations → Linear

   Press Connect Linear account, or pick an account the workspace already connected. A popup walks you through OAuth consent. Scopes requested: read, write, issues:create.

2. 2

   Pick a team

   Issues will land in this team's backlog. Each integration targets one team — add another integration to route to a second team.

3. 3

   Set defaults (optional)

   Pick a project. It applies to every issue and resets when you switch teams.

4. 4

   Compose title and description

   Use the template editors. Type @ to insert form field values or submission metadata such as PDF Link. Title renders as plain text (max 255 characters); description renders as markdown.

5. 5

   Abandoned submissions (optional)

   Pick an idle window and write a separate title and description for drafts nobody finished. Leave it Off to skip. Requires Pro or Business.

6. 6

   Finalize

   Send test creates a real issue with a [Test] prefix in the chosen team — archive or delete it afterwards. Then press Create integration and every submission creates a Linear issue.

Backfill existing submissions

When you first connect, you can export existing submissions as Linear issues. The backfill runs in the background at ~1 issue per second to stay within Linear’s rate limits. Progress is logged every 10 submissions.

Abandoned response events

When a respondent starts your form but doesn’t finish, formbase can create a separate issue for the partial data. Set Send abandoned event after to 12 hours, 1 day, 3 days, or 1 week, then fill in the abandoned issue title and description — neither can be empty. Abandoned issues get a partial-submission label.

An hourly sweep looks for idle drafts, so the issue appears at the first sweep after the window passes. Only drafts from a share link are swept, and Required fields narrows it further: the issue is created only when at least one of the fields you pick was filled in.

Token refresh

Linear access tokens refresh automatically before each dispatch when close to expiry. If refresh fails (token revoked, app uninstalled), formbase marks the integration as error and you receive a failure notification email. Reconnect from the workspace Integrations page to restore.

Removing the integration

• From formbase — Form settings → Integrations → Linear → Delete. New submissions stop creating issues immediately.

• From Linear — Revoke the OAuth grant from your user settings. The next dispatch fails and the credential is marked expired.

Limits and behavior

• One issue per submission — no comment-on-existing-issue mode
• Title is plain text, truncated with an ellipsis past 255 characters; description is markdown-only

• An empty title falls back to New submission to <form name>

• File upload answers render as the file name followed by its download link, so the file is reachable from the issue

• A repeating group field inserted with @ renders every entry joined by “ · “

FAQ

Next steps