DocsBack to homepage

Start Here

  • Getting Started
  • Key Concepts

Design Tokens

  • Token Types
  • Token Modes
  • Token Enforcement
  • Deprecated Tokens
  • Quality and Accessibility

Components

  • Component Builder
  • Composition Rules

Publishing

  • Publishing
  • Docs Mode
  • Changelog Notifications
  • Notifications and Alerts

Integrations

CLI & Data

  • CLI Reference
  • CLI Configuration
  • Import Formats
  • Importing Tokens
  • Export Formats

Tooling

  • Studio AI Assistant
  • Figma Plugin
  • API Reference
  • Webhooks

Account & Billing

  • Audit Log
  • Security and Access
  • Account Security
  • Pricing and Payments

Documentation

Notifications and Alerts

ReframeUI delivers alerts through two channels: an in-app notification bell and email. You control what you receive at the account level, with the option to override those settings for individual workspaces. Slack alerts are a separate, org-level broadcast to a shared channel.

How notifications reach you

The notification bell in the Studio top bar shows a feed of events as they happen: publishes, branch reviews, and team invites. No action is needed to activate it.

Email alerts go to the address on your account. Publish alerts, branch review alerts, and team invite notifications deliver to both the bell and your email. Billing emails are email-only.

Personal notification preferences

Your account has four global toggles that control which event types notify you. To reach them: open Studio, click your avatar in the top-right corner, select Account Settings, then open the Notifications tab.

ToggleDefaultWhat it controls
Publish alertsOnNotified when any project in your organizations publishes a new version
Branch review alertsOnNotified when someone requests your review, or responds to a request you made
Team invitesOnNotified when you are invited to an organization
BillingOnReceipts and subscription updates for your account

All four default to On. Turning one off silences that event type across all your workspaces.

Note: The per-workspace table below lets you deviate from these globals for individual projects. When a project row shows Default, it follows your global setting above. Setting a project row to On or Off overrides the global for that project only.

Per-project notification preferences

Each team member can control which projects send them notifications. These are personal toggles and do not affect the Slack channel alerts, which go to the whole connected channel regardless of individual settings. The Default option in each row inherits from your global account settings above.

Publish alerts

Receive a notification when this project publishes.

Branch alerts

Receive a notification when a branch review is requested on this project.

Default means this project follows your global account setting for that event type. If you turned publish alerts off globally, a project set to Default will also be off for you. Setting a toggle to Off silences that event for the project in your personal feed.

Note: The Slack channel alert is a team-wide broadcast. Your per-project toggles only affect what you see in your notification feed inside Studio.

Slack integration

The Slack integration is an org-level setting. One channel receives alerts for all projects in your workspace. When a design system is published or a branch review is requested, ReframeUI sends a formatted message to that channel.

Connecting a workspace

Only the org owner can connect or disconnect the integration. Editors and viewers see the connection status but cannot change it.

To connect:

  1. 1.Open Studio and go to Settings, then Notifications.
  2. 2.Click Connect Slack.
  3. 3.Slack OAuth opens. Select a workspace and channel, then click Allow.
  4. 4.The browser returns to Settings. A green Connected badge shows the workspace name and channel name.

Required Slack permissions

The only scope requested is incoming-webhook. This gives ReframeUI permission to post messages to a single channel. ReframeUI does not request access to read messages, list channels, or manage workspace members. The webhook is tied to the channel selected during setup and cannot be redirected without reconnecting.

Disconnecting

The org owner clicks Disconnect in Settings, then confirms the dialog. After disconnection, no further Slack messages are sent. To post to a different channel, reconnect and select the new channel during the OAuth flow.

Events that trigger notifications

Two events send a Slack message to the connected channel.

EventWhen it fires
PublishA project version is published to main. The message includes the project name, version number, bump type (major, minor, or patch), and a summary of changes.
Branch review requestedA branch is submitted for review. The message names the requester and reviewer, with a link to the branch preview in Docs.

Note: Branch approval and rejection do not send a Slack message. Only the review request fires.

Continue reading

Branch review and approval, Publishing a design system, or Audit log.