Linear Integration

Linear connects Woes support issues to your product and engineering workflow. Use it to turn customer pain, bug reports, docs gaps, and feature requests into Linear issues while keeping the original support context attached.

Connected Linear integration card in Woes workspace settings.

At A Glance

Use Linear for	Where it appears
Turning support issues into product or engineering work with a visible linked Linear issue.	Integrations, Issues, Automations, and customer-safe issue views.

What Linear does in Woes

Capability	What you can do
Connect Linear	Admins connect a Linear workspace from Workspace Settings -> Integrations -> Linear.
Choose a team	When creating a Linear issue, choose the Linear team that should own the work.
Create linked issues	Create a Linear issue from a Woes support issue with the customer problem, account context, channel, priority, and support summary attached.
Keep the link visible	Open the linked Linear issue, see its key and status, or unlink it from the Woes issue drawer.
Sync status	When a linked support issue or Linear issue changes lifecycle status, Woes keeps the other side aligned where possible.
Automate handoff	Use the Create Linear issue automation action for issue workflows, such as high-priority bugs or repeated feature requests.
Share safe customer context	Customer-facing issue summaries can show the linked Linear issue key, status, and URL without exposing private workspace details.

Linear is a workflow integration. It is not a support channel, and Woes does not use Linear issues as documentation for the AI agent.

Where it appears in Woes

Workspace Settings -> Integrations — connect, reconnect, disconnect, and confirm the Linear connection.
Issues — create a Linear issue from a Woes support issue, choose a team, open the linked Linear issue, or unlink it.
Automations — add the Create Linear issue action to issue workflows.
Customer issue views — show safe linked Linear issue details when a Woes issue already has a Linear link.

Connect Linear

In Woes, open Workspace Settings -> Integrations.
Select Linear.
Click Connect.
Approve the requested Linear permissions.
Return to Woes and confirm the Linear card shows Connected.

After connecting, open any Woes support issue and choose Create Linear issue from the issue actions. Pick the Linear team, review the issue title and description, and create the linked Linear issue.

If status sync or issue creation does not work after reconnecting, ask a Woes workspace admin to disconnect and reconnect Linear so the latest permissions are granted.

Status sync

Woes maps support issue lifecycle states to the closest matching Linear workflow state available on the selected team.

Woes issue status	Linear workflow behavior
New	Moves the linked Linear issue to an intake or unstarted state when available.
On you	Moves the linked Linear issue to an active or started state when available.
On customer	Keeps the linked Linear issue in an active or started state when available.
On hold	Moves the linked Linear issue to a backlog or paused state when available.
Closed	Moves the linked Linear issue to a completed or canceled state when available.

If a Linear team uses custom workflow states, Woes chooses the closest available state type. If there is no reasonable match, the link remains visible and the issue can still be managed manually in Linear.

Automations

The Create Linear issue automation action is available for issue workflows. It uses the same Linear connection as manual issue creation and avoids creating duplicate Linear issues for the same Woes issue. Good automation patterns:

Create a Linear issue for new high-priority bug reports.
Create a Linear issue when a support issue receives a docs-gap tag.
Create a Linear issue for repeated customer requests after triage.

Permissions and privacy

Woes asks Linear for the permissions needed to read basic workspace information, create issues, and keep linked issue status up to date. Woes only shows customer-facing Linear details that are useful for tracking work, such as the linked issue key, status, and URL. Private Linear connection details are not shown in customer issue views.

Current boundaries

Woes creates Linear issues from Woes support issues; it does not create Woes support issues from unrelated Linear issues.
Woes syncs lifecycle status. Linear comments are not posted as customer-visible replies; when available, linked Linear comment activity may appear as operator-only internal notes in Woes.
Woes does not mirror Linear assignees, labels, projects, estimates, or cycles yet.
Woes does not import Linear issues into the Context Library.
Automation rules create or keep one Linear link per Woes issue. They do not yet choose a specific Linear project, label, cycle, or assignee per rule.

Troubleshooting

Problem	What to check
Linear will not connect	Make sure you are a Woes admin and that your Linear account has permission to install apps for the Linear workspace.
You cannot create a Linear issue	Reconnect Linear, then confirm you have access to at least one Linear team.
Status does not sync	Reconnect Linear so Woes has the latest permissions, then confirm the linked Linear team has an active workflow state that matches the Woes issue status.
Automation does not create a Linear issue	Confirm the automation is published, enabled, and uses an issue workflow trigger.
The wrong team owns the work	Open the Woes issue, unlink the Linear issue if needed, and create a new Linear issue under the correct team.

​Linear Integration

​At A Glance

​What Linear does in Woes

​Where it appears in Woes

​Connect Linear

​Status sync

​Automations

​Permissions and privacy

​Current boundaries

​Troubleshooting

​Related docs

Linear Integration

At A Glance

What Linear does in Woes

Where it appears in Woes

Connect Linear

Status sync

Automations

Permissions and privacy

Current boundaries

Troubleshooting

Related docs