Linear issue forms

Introduction

In this tutorial, we will create a bug report form and connect it to Linear so it will create a new issue for each form submission. The bug report form asks for basic contact info, issue type selection, file uploads, and comments. When configuring the Linear workflow we can optionally set properties like assignee, labels, due date, and priority.

Create a new form

On your Formcrafts dashboard ↗ click on Add Form → Start from scratch. Enter a Form name and hit enter. This will create a new form.

You can also create a new form by clicking on Add Form → Use a Template and selecting a template. This would allow you to skip this step. We have a large collection of customer support form templates ↗ that you can use.

Now add some basic fields to your form using the Add field button on the top-left corner of the form editor:

1. Rich text field
2. Name (One line text)
3. Email (Email)
4. Issue type (Multiple choice)
5. Attachments (File upload)
6. Comments (Comment)

Create an action

Click on the Workflows button on the top-left corner of the form editor, and then click on the Add workflow button.

Now edit the new workflow, and click on Add action. Under (select action) find Linear, and click on Connect to Linear.

This will open a popup window where you can connect to your Linear account. Next you will configure the action and set the appropriate fields.

You can use the @ key to reference form fields. For example, to reference the Name field, you can use @Name. This allows you to dynamically set the issue title, description, and other fields based on the form submission.

For date fields you can use a relative date, example +7 days, +1 month, +1 year. This will set the due date to 7 days, 1 month, or 1 year from the current date.

You can use the Map other fields section to configure things like assignee, labels, issue state, due date, priority, and other fields.

Save and test

Click on the Preview button on the top-right corner of the form editor, and submit the form to test the workflow.

Formcrafts keeps a record of all successful and failed workflows which you can view using the Logs button on the top-left corner of the form editor.

Learn more about Workflow logs.

Notes

Conditional workflows

By default the Linear action(s) is triggered on each form submit. We can add conditions to our workflow to trigger the action(s) only when certain conditions are met. Edit your workflow and click on Add condition. Here you can add conditions, or even create condition groups.