When your engineering team ships product changes in Linear, your help center documentation can quickly fall out of date. Pageloop bridges this gap by connecting directly to your Linear workspace and monitoring completed issues for changes that affect your docs. Instead of manually tracking updates, Pageloop automatically analyzes completed engineering work to generate actionable suggestions.
You can also trigger a proactive suggestion by mentioning @Pageloop on a Linear issue. Pageloop uses the issue content and surrounding discussion as context when generating the suggestion.
Connect Pageloop to Linear
To connect your Linear workspace and start generating proactive suggestions, follow these steps:
Navigate to the Integrations section from the left sidebar and locate the Linear integration card.
Click the Connect button on the Linear card. You will be redirected to Linear to request workspace access. Click Authorize to grant Pageloop read access.
After authorizing, you are redirected back to Pageloop. In the Configure Linear dialog, click the dropdown menu to view your available teams.
Select the appropriate team from the list. You can optionally select one or more specific projects to filter issues and improve suggestion accuracy.
Click Save Configuration. A success notification appears, and the Linear card displays a green Connected badge.
If you need to change which team Pageloop monitors, disconnect the Linear integration from the Integrations page and reconnect it to choose a different team or project scope.
How Pageloop Generates Suggestions
Once configured, Pageloop periodically scans for recently completed issues within your selected team and projects. It analyzes the issue title, description, labels, comments, and linked resources against your existing help center content.
Suggestions can come from completed issues identified automatically or from direct @Pageloop mentions on a Linear issue.
Based on this analysis, Pageloop generates two types of suggestions:
Update suggestion: Recommends changes to existing articles that may be outdated due to completed work.
Create a new article: Recommends a new article when the completed issue covers undocumented functionality.
Pageloop generates suggestions for various scenarios, including:
Bug fixes: Changes to existing behavior.
New feature releases: New functionality marked as done.
UI redesigns: Groups several completed issues to suggest updates to navigation or getting started guides.
API changes: Identifies affected integration guides based on endpoint changes.
Performance improvements: Evaluates if load speed changes impact customer-facing troubleshooting steps.
Manage Your Suggestions
You can review newly detected suggestions in the Suggestions tab. Allow some time after initial setup for the first suggestions to appear, depending on your team's issue completion frequency.
Suggestions triggered from direct @Pageloop mentions in Linear also appear in the Suggestions tab.
Each suggestion includes a title, a summary of what changed, AI reasoning, and source logs describing the flagged issue. If Pageloop detects a completed issue related to an existing suggestion, it updates the existing suggestion with additional context rather than creating a duplicate.
The Suggestions feature is available on all plans.
Next Steps
Now that you have connected Linear, learn how to review and apply these insights by Working with Proactive Suggestions. You can also explore how to Create Articles Using Pageloop to expand your knowledge base.
Frequently Asked Questions
Will Pageloop create suggestions for every completed issue?
No. Pageloop analyzes each completed issue and only generates a suggestion when it identifies a meaningful documentation gap or an outdated article. Routine maintenance tasks, internal tooling changes, and issues that do not affect customer-facing documentation are typically filtered out.
Can I monitor more than one Linear team?
Pageloop supports monitoring one Linear team per workspace. You can narrow coverage within that team by selecting one or more projects in the configuration dialog. You can change which team is monitored by disconnecting and reconnecting the Linear integration from Settings > Integrations. The configuration dialog will appear during reconnection.
Why am I not seeing any suggestions from Linear?
There are a few reasons suggestions may not appear:
No recently completed issues: Pageloop only analyzes issues that have moved to a completed state. If no issues have been completed recently, there is nothing to analyze.
Team not configured: Make sure you have selected a team in the Linear configuration dialog. The integration remains inactive until a team is selected.
Projects selected: If you selected one or more projects, Pageloop only analyzes completed issues from those projects. Verify that the work you expect to trigger suggestions belongs to the selected projects.
Allow time for processing: After initial setup, allow some time for the first suggestions to appear as Pageloop needs to run its next scheduled scan.
Issues do not affect documentation: If completed issues are primarily internal changes that do not impact your Help Center content, Pageloop may not generate suggestions.
What Linear permissions does Pageloop require?
Pageloop requests read-only access to your Linear workspace during the OAuth authorization step. This allows Pageloop to view team information and read completed issues. Pageloop does not modify any data in your Linear workspace.
Can I disconnect Linear and reconnect later?
Yes. You can disconnect the Linear integration from Settings > Integrations at any time. If you reconnect later, you will need to go through the OAuth authorization and team selection process again.