Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.feedovate.com/llms.txt

Use this file to discover all available pages before exploring further.

Connect Feedovate to Linear so customer feedback and engineering work stay aligned. Push feedback into your backlog, link existing issues, keep statuses in sync both ways, and jump between tools without copy-pasting.

​
Why Connect Linear?

Single Source of Truth

Each feedback post maps to at most one Linear issue. Everyone sees the same identifier on both sides.

Two-Way Status Sync

Map Feedovate statuses to Linear workflow states. Updates in either tool flow to the other automatically.

Work Where You Ship

Engineers stay in Linear. Product and support stay in Feedovate. Links and sidebar cards bridge the gap.

Import from Linear

Tag an issue with the Feedovate label in Linear to create a linked feedback post — ideal for work that started in engineering first.

​
How Two-Way Sync Works

Feedovate and Linear stay connected through links, sync rules, and webhooks.
DirectionWhat happens
Feedovate → LinearYou push or link feedback, or enable auto-push. Status changes on linked feedback update the issue state when a matching sync rule exists.
Linear → FeedovateWhen a linked issue’s workflow state changes, Feedovate updates the feedback status using the same rule (in reverse).
Linear → Feedovate (import)Adding the Feedovate label to an issue creates a new feedback post and links them — if the issue is not already linked.
Sync rules are the control surface. If a status or state is not mapped, changes on that side are ignored for sync — nothing breaks, but the other tool will not update.

​
Connect Your Workspace

Feedovate integrations page with Connect to Linear

Open Integrations

In your Feedovate dashboard, go to Settings → Integrations.

Authorize Linear

Click Connect to Linear. You are redirected to Linear to sign in and review what Feedovate can access.Feedovate requests read and write access so it can list teams and workflow states, create and update issues, and manage issue links. Webhooks are configured at the Feedovate OAuth app level in Linear — you do not need to paste a webhook URL during setup.

Finish setup

Click Authorize on Linear. You return to Feedovate with Linear marked as connected. Open Configure on the Linear card to add sync rules and turn on auto-push if you want automatic two-way sync.
You need the Manage integrations permission (integrations.manage). Workspace Admins have this by default; other roles only if granted via a custom role.
Choose your preferred team when you connect with Linear — that selection sets where Feedovate creates issues and loads workflow states. To switch teams later, disconnect and reconnect from Settings → Integrations.

​
Sync Rules

Linear sync rules configuration in Feedovate
Sync rules pair one Feedovate status with one Linear workflow state. They power bidirectional status updates for linked feedback only.

​
Add a rule

  1. Go to Settings → Integrations → Linear → Configure
  2. Under Sync rules, click New rule
  3. Choose a Feedovate status and a Linear state from your default team
  4. Click Add rule
Each Linear state can only appear in one rule. Remove a rule with the × on its row to remap that state.

​
What syncs automatically

EventResult
You change status on linked feedback in FeedovateLinear issue moves to the state mapped to that status (if a rule exists and the issue is not already in that state)
Someone changes workflow state on a linked issue in LinearFeedovate feedback status updates to the status mapped to that state
Status or state has no ruleNo automatic update on the other side
Feedovate uses echo detection so its own Linear updates (from outbound sync) do not bounce back and forth. You should not see status flicker or duplicate updates under normal use.

​
Auto-Push New Feedback

Auto-push new feedback toggle in Linear integration settings
Enable Auto-push new feedback under Settings → Integrations → Linear → Configure when you want every new feedback post (portal or admin) to become a linked Linear issue in your default team automatically — no manual push step. Each auto-pushed issue uses the same title, description, Feedovate label, and initial state logic as manual push (including sync rules for initial state when applicable). With sync rules configured, status changes on linked feedback and issues stay in sync both ways.
Linear section on a feedback post with push and link options
On any feedback detail view (when Linear is connected), use the Linear section:

Create new

Push to Linear creates an issue in your default team with the feedback title and description. The issue is tagged with the workspace Feedovate label and shows a Feedovate card in Linear’s sidebar.

Link existing

Search by title or issue ID (e.g. ENG-123), pick a match, and link. Feedovate adds the Feedovate label if missing and attaches the sidebar card.
ConstraintDetail
One link per feedbackA post cannot link to two Linear issues
One link per issueA Linear issue cannot link to two feedback posts
UnlinkRemoves the link and the Feedovate sidebar card in Linear. Does not delete the Linear issue
After linking, open the issue identifier in Feedovate to jump to Linear in a new tab.

​
Push Linear issues to Feedovate

Assign the Feedovate label on a Linear issue to sync it into Feedovate
Work that starts in Linear can flow into Feedovate: assign the Feedovate label on an issue to create a linked feedback post and keep statuses in sync (when sync rules apply). On connect, Feedovate adds a workspace-level Feedovate label in Linear (purple, #5E6AD2) so your team can tag issues in one click.
UseBehavior
Visual markerIssues you push or link from Feedovate are tagged so the team can see they came from customer feedback
Push to FeedovateAssign the Feedovate label on an issue (on create or update) to import it as linked feedback if one does not exist yet
Imported feedback:
  • Uses the issue title and description
  • Gets a status from sync rules (based on the issue’s current state) or your project’s default status
  • Is created as private (internal) so your team can review before publishing to the portal
  • Appears with source Linear in the dashboard
Linked issues show a native Linear attachment on the issue sidebar:
  • Title — feedback title
  • Link — opens the feedback in Feedovate admin
  • Subtitle — “View on Feedovate”
This gives engineers context without leaving Linear. Unlinking or disconnecting removes these cards; issues remain in Linear.

​
Disconnect Linear

Disconnecting stops all sync immediately and removes stored links and sync rules. Linear issues are not deleted.
  1. Go to Settings → Integrations
  2. Open Linear → Configure
  3. Click Disconnect and confirm
After disconnecting:
  • Status sync and webhooks stop for this project
  • Feedback ↔ issue links are cleared
  • Feedovate sidebar cards on Linear issues are removed when possible
  • You can reconnect anytime; you will need to set up sync rules again
To revoke Feedovate’s access entirely, also remove the app under Linear → Settings → API → OAuth applications.

​
Troubleshooting

  1. Confirm the feedback is linked to a Linear issue (identifier shown on the feedback page)
  2. Check that a sync rule exists for the status or state you changed
  3. Remember: unmapped statuses or states never sync
  4. Wait a few seconds — Linear webhooks are near-real-time but not instantaneous
Disable Auto-push new feedback under Linear settings. Existing issues stay in Linear; unlink individual posts in Feedovate if needed.
Label-triggered imports are private by design. Open the post in admin, review it, then publish when ready.
Use Retry in the sync rules panel. If it persists, disconnect and reconnect Linear, and confirm your Linear account still has access to the default team.
Connecting Linear requires Manage integrations. Ask a workspace Admin to connect, or grant that permission to your role.
Team access is chosen on Linear’s authorization screen, not inside Feedovate.
  1. Go to Settings → Integrations → Disconnect Linear
  2. Click Connect to Linear again
  3. On the authorize screen, select Only select teams… and pick the correct team(s), then click Authorize
New pushes, auto-push, and sync-rule states use the team(s) you grant on that screen.

​
Privacy & Data

Feedovate sends to Linear only what is needed to sync:
  • Feedback title and description (on push or import)
  • Issue and workflow metadata (IDs, states, labels)
  • OAuth tokens stored encrypted for your project
Feedovate does not read your full Linear inbox or unrelated issues except when you search to link an existing issue. Webhook payloads are verified with a signing secret before processing. Tokens are scoped to your connected workspace.

​
Next Steps

Manage Feedback

Triage feedback before or after you push it to Linear.

Roadmap

Keep customers informed while engineering works in Linear.

Slack Integration

Alert the team in Slack when new feedback arrives.

Team Collaboration

Control who can connect integrations and manage feedback.