Project updates

Keep team members informed on the health and progress of projects in Linear and Slack.

Overview

Project updates are short status reports on the health of your projects. They can be viewed in Linear and sent directly to Slack channels. They consist of two main components: a health indicator that provides a high-level signal of the current state of the project, and a rich text description to provide more in-depth information on the status and progress.

For more granular updates on individual projects, you can additionally configure project notifications to your personal Inbox and Slack.

Configure

Configure project updates for your workspace under workspace settings. Select a Slack channel where updates will go (we recommend a dedicated one such as #project-updates) and set optional reminders to remind project leads to post an update at a regular cadence (e.g. post an update weekly on Wednesdays).

Configure notifications for specific projects by clicking the bell icon from the project view (it's next to the Updates button). From there, you can link the project to it's own Slack channel (e.g. #p-project-name) to send updates and notifications there. You can also enable personal notifications in account notifications settings.

Basics

Create project updates

The easiest way to write updates is by opening the reminder in your Inbox. You can also write updates from any project or related roadmap view by selecting the Updates button in the top right of the view.

If you're blocked from doing so, check that you're a member of the project by going to project details (Cmd/Ctrl I). Only members of a project can post updates.

View project updates

Project updates can be viewed from any individual project, team projects, or roadmap view by clicking on the Updates icon or by using Shift + U keyboard shortcut.

Project updates appears in chronological order and anyone (not just team members) can react with emoji to express sentiment.

You can also view project updates from Slack (see below to configure those).

You can additionally copy a link to share with your team, or copy a project update as markdown through the ⌘/Ctrl + K menu.

How we work: The project lead adds weekly project updates. As well as viewing these in Linear, we have these set up to appear in a specific channel in our Slack workspace. We can then easily discuss each update in a Slack thread originating from the original posted message.

During weekly syncs, we'll review project updates directly in Linear. We take a few minutes to silently read them and emoji react depending on how we'd like to discuss them in the meeting. ✋ means you have a question, ▶️ means you want to see a demo, and we usually see a few others like 🚀🙌 🥳.

Progress reports for projects

Project updates include a concise overview of project progress since the last update. It covers information such as project delays, changes in the target date, assignment of new leads, progress towards milestones, and overall progress. These updates help you track project changes and effectively communicate progress to stakeholders.
A detailed list will be generated showing changes, and you can optionally hide those details from being included in your update if needed.

Additionally, progress reports are automatically shared on Slack through the project updates Slack integration discussed below.

Send project updates to Slack

Configure all project updates in your workspace to post to Slack in project updates settings or Slack integration settings. This will become a feed of all company projects, so we recommend using a dedicated channel (e.g. #project-updates).

To additionally send a specific project's updates to a different channel (e.g. #p-project-name), click on the bell icon in the project view. You can only link one Slack channel to an individual project in Linear, so project updates will go to the same channel as project notifications if you have those configured. Edits in updates will also be reflected in Slack if you have the Slack integration enabled.

Project update comments

It's possible to comment under project updates to discuss them further. People who wrote the update and all people who participated will be notified about new comments in their inbox.

Project update comments sync to Slack

If you have setup project updates to send to Slack, comments to the project update will sync to Linear, in the same way we sync Slack comments on issues.

Project update reminders

Turn on project update reminders for project leads in your Project updates settings. Once turned on, you can decide the frequency reminders should be sent as well as the day and hour (in each lead's local timezone) they should be sent on. Project update reminders are for projects that are "In Progress", only. For more information around receiving project update reminders, please see the FAQ at the bottom of this page.

Project notifications

Link projects to a specific Slack channel to see notifications when an update is posted or when issues in that project are created, receive comments, and/or have changed status. Anyone in Slack can see the notification details and anyone with a Linear account can take actions on the issue directly from the Slack notification (e.g. comment on issue).

How we work: We checkin on active projects regularly during meetings and share async updates and requests for feedback in Slack. We create a Slack channel for every project (#p-project-name) and will send Linear project notifications there (but we leave it up to the project team to decide if they want them).

Personal notifications

Receive a notification in your Inbox whenever a new issue is created in the project, a comment is made in a project issue, or an issue is marked as completed or canceled. You can choose which notifications you want and manage these notifications by clicking the bell in the project view or under account notifications settings.

There is also the ability to subscribe for project updates and receive inbox notifications when a new project update for this project is posted.

FAQ