Release Notes Newsletter

Email stakeholders an AI-curated summary of the user-facing features each release ships, with an optional review step and images.

The release notes newsletter tells people outside your team what changed. Fabric reads the releases in the project's connected repositories, picks the major user-facing features, and writes a short summary for each one. It can send on a schedule or when you click Send now, and it can hold each issue for an admin to check first.

You set it up per project under Settings → Newsletter.

Set it up

Connect at least one repository under Settings → Development. The newsletter reads releases from the project's active repository connections.
Open Settings → Newsletter and add subscribers under Audience. You can paste several email addresses at once, separated by spaces, commas or new lines. Turn on Send to entire organization to add everyone in the organization before each send. People who unsubscribed stay unsubscribed.
Choose the Cadence, Day of week and Send hour (UTC), then turn on Enable newsletter. Without it, the newsletter sends only when you click Send now.

Setting	What it does
Lookback window (days)	The minimum days of history each send covers. Leave it blank to send only what is new since the last send. A value larger than your cadence includes releases that were already announced.
Detail level	How much each summary says. Standard is the default.
Delivery destination	Where the newsletter goes. Email sends to subscribers.

If Fabric finds no major features, nobody is emailed and the send history shows why.

Review before sending

Turn on Require review before sending to hold each newsletter until a project admin approves it. When a newsletter is held, reviewers get an in-app notification and an email (when mail is configured). You can also tick Teams or Slack channels under Review alert channels to post the alert there.

Click Review on the held newsletter to open it. In the review dialog you can:

untick a highlight to leave it out of the email;
drag a highlight to change its order within its release;
click Approve & send to deliver it now, or Reject to discard it.

A held newsletter that nobody reviews for 14 days is marked Review expired the next time a send runs, and it is never delivered.

Add images to highlights

Turn on Images in highlights to let reviewers add up to two images to each highlight. Images are added in the review dialog, so this setting needs Require review before sending as well.

Click Add image under a highlight and pick a PNG or JPEG file. Files up to 300 KB are used as they are. Your browser scales a larger file down to 1200 px wide and compresses it until it fits, before it uploads.

Click an image to change it:

Control	What it does
Include in email	Untick to keep the image with the highlight but leave it out of this email.
Description	Text shown to readers whose mail app blocks pictures.
Shown under	Moves the image to another highlight.
Replace, Download, Remove	Swap the file, save a copy, or delete the image.

The footer counts how many images are included, and the approve button names that number. Images go out only in a newsletter you approve. When you reject a newsletter, or its review expires, Fabric deletes its images.

Send history

Send & history lists every send with its trigger, status and delivery count. Click Send now to start one immediately.

Status	Meaning
Preparing…	Fabric is writing a newsletter that will be held for review.
Awaiting review	Held until an admin approves or rejects it.
Sending…, Sent, Partially sent, Failed	Delivery progress and outcome.
Rejected, Review expired	Not delivered.
No new releases, No major updates	Nothing new to announce, so nobody was emailed.
Scan incomplete	Fabric could not read every connected repository, so it sent nothing. A partial scan could miss a release. The row lists the repositories that failed and the error each returned.
No subscribers	The audience is empty.
Repositories disconnected	The project has no active repository connection.

Fixing a scan that is incomplete. The reason under Scan incomplete names the repository. Give the connected account access to it, or remove the repository from the project under Settings → Development, then click Send now. If a repository's credentials have expired, the newsletter settings show a Reconnect repositories banner.

Embed on your site

Under Embed, turn on Enable the embeddable widget to publish the project's release notes at a public widget URL. Style the widget to match your site, then paste the snippet into your HTML.