Linear is an issue tracking and project management tool that helps streamline software projects, sprints, tasks, and bug tracking.

Hellonext now gives you the option to integrate with Linear. We have built an extensive one way integration with Linear, which allows your team members and admins, to link or create Linear issues directly from Hellonext.

You might come across instances where your customer reports an issue on one of your boards and you would wanna push that into your Linear workspace. You can now effortlessly manage your issues from Hellonext and thereby streamline projects, tasks, and bug tracking on Linear with ease!

This article covers:

Getting started with the Hellonext - Linear integration
Scope for Hellonext - Linear Integration
How the integration works
- Create a Linear Issue
- Link Linear issues
- Enable Automatic Push to Linear
- Set status sync rules
How to unlink a Linear Issue from a Hellonext post

Getting started with the Hellonext - Linear integration:

Sign in to your Hellonext organization and access your Admin Dashboard.
Click on Organization Settings from the bottom left corner.
Toggle to the Integrations tab → go to the Linear section and click on Connect.
Log in to your Linear account.
Next, Authorize Hellonext to access your Linear workspace.
You will now be redirected back to your Hellonext Integrations section where you can see the name of the Linear workspace that your Hellonext organization is connected to along with the Linear username.

Scope for Hellonext - Linear Integration:

read - Read Team, Issue and User data from Linear. 

write - Add attachment to the Linear issue. 

issues:create - Create a new issue on linear.

Configuration - Enable Automatic Push to Linear

You can enable this toggle to push posts from Hellonext to Linear according to the rules you will set. Once the push rule is set, click on Save to save the changes.
1. The initial rule you set for “Automatic Push to Linear” is when you change the status of the posts to one of the available statuses in the dropdown, the respective posts will be pushed to Linear.
2. Push posts immediately after submitting - To automatically push posts to Linear as soon as they are created on Hellonext - you must enable the check box “New posts in In Review status will automatically be sent to Linear.”
1. Post moderation enabled - To automatically push posts to Linear as soon as they are approved in moderation, on Hellonext - you must enable the check box “Posts approved in In Review status will automatically be sent to Linear.”

Set status sync rules

You can now set Sync rules to update the statuses of linked Linear issues and Hellonext posts. You can click on the + Add Sync Rule button to start adding rules! There are three types of Sync rules you can set:

When Any linked Linear issue in one of the teams is changed to a set Status, change linked Hellonext posts to the set Status and Notify / Do not Notify voters and subscribers.
When All linked Linear issue in one of the teams is changed to a set Status, change linked Hellonext posts to the set Status and Notify / Do not Notify voters and subscribers.
When a Hellonext post is changed to a set Status, change all linked Linear issues in one of the teams to the set Status.
Click on the Add Rule button to save the set rule.

How it works?

Hellonext - Linear integration is a one-way integration between Hellonext and Linear where you can push posts from Hellonext as issues into your Linear workspace.

Once the Integration setup is complete, you will see a Push to Linear button within all your posts on Hellonext, on the right panel.
Clicking on Push to Linear will give you two options:

Create a Linear Issue:

Please note that only one linear issue can be created from a Hellonext post.
In the Create tab, you can modify the Title and Description of the issue before you Push to Linear.
Choose the relevant Linear Team, Project, Assignee, Labels and State with which the issue will be pushed to Linear.
You can also set a parent post for the current issue you are pushing by searching for a Linear issues using title or description.
Click on Push to Linear once done.
Instantly, an issue would be created on linear and you can also find the Hellonext post linked to the Linear issue.
Similarly, the Linear issue created will also be linked to the specific Hellonext post.
You can also notice that once a Linear issue is created from a Hellonext post you will not longer find an option to Push to Linear.
Rather you'll find Link Linear Issues. This is because of the aforementioned rule. You will only be able to create one linear issue can be created from a Hellonext post. But link many Linear issues to a single Hellonext post.

Link Linear issues:

You can link multiple Linear issues and sub-issues to a single Hellonext post.
Toggle to the Link tab and search full-text for an issue or sub-issue on Linear via title or description.
Click on the Link button to link a Linear issue or sub-issue to the Hellonext post, from the search result.
This way you can link multiple Linear issue or sub-issues to a single Hellonext post and the relevant Hellonext post will be linked to Linear issue or sub-issue too.

How to unlink a Linear Issue from a Hellonext post?

Unlinking a Linear issue from a Hellonext post is quite straightforward. You can simply click on the Unlink icon for that issue in the Hellonext post. This will also remove the Hellonext post association with issue on Linear.

Seems rather easy and simple to follow doesn’t it? That’s because it is!

Do feel free to reach out to us if any queries should arise! 😄🙌🏼

How can we help you?

Linear Integration