Skip to content

Update from code changes: document notification preferences - #7208

Merged
ethanpalm merged 9 commits into
mainfrom
mintlify/14ed552d
Sep 8, 2026
Merged

Update from code changes: document notification preferences#7208
ethanpalm merged 9 commits into
mainfrom
mintlify/14ed552d

Conversation

@mintlify

@mintlify mintlify Bot commented Sep 1, 2026

Copy link
Copy Markdown
Contributor

Summary

Email notification preferences are now generally available to all organization members in dashboard settings, so this adds documentation for the Notifications page.

Every org member now sees a Notifications page in dashboard settings where they can toggle emails for comments, suggestions, automation runs, and page feedback. The page also hosts the existing admin contact email and security contact settings for admins, and the old security contact settings URL now redirects there. Previously the notification preferences section was behind a feature flag, which has been removed. See https://github.com/mintlify/mint/pull/10613 and the paired server change https://github.com/mintlify/server/pull/7867

Changes

  • Add dashboard/notifications page covering per-user email preferences, defaults, and admin-only organization notification settings
  • Document the "Reaction to your comment" preference (off by default) now that the reaction row shipped in the dashboard preferences UI
  • Update security contact page to point to the Notifications settings page (old URL redirects)
  • Add cross-links from editor collaboration and automations pages to notification preferences
  • Mirror all changes into French, Spanish, and Chinese translations, including navigation config updates

Notes

  • Default preference states (comment/suggestion emails on; reaction, automation run, and feedback emails off) were verified against the server defaults.
  • Slack delivery fields exist in the data model but are not exposed in the UI, so the docs only describe email notifications.
  • The expanded reaction picker itself (searchable full emoji set) was already documented on the collaborate page by a prior docs update, so this PR only covers the new notification preference.

Update history

  • Documented the Notifications settings page and cross-links, with es/fr/zh translations (from https://github.com/mintlify/mint/pull/10613)
  • Reviewed the paired server-side flag removal (https://github.com/mintlify/server/pull/7867); it makes email dispatch match the behavior already documented here (emails send subject to per-user preferences), so no additional docs changes were needed
  • Reviewed comment reaction notifications (https://github.com/mintlify/server/pull/7904); backend-only with no dashboard UI surface yet (no inbox component, no reaction row in the preferences UI), so no docs changes were made
  • Documented the "Reaction to your comment" email preference and its off-by-default state on the notifications page (en/es/fr/zh) now that the preferences UI row shipped (https://github.com/mintlify/mint/pull/10624); the reaction picker changes were already covered on the collaborate page
  • Removed the per-category bulk toggle claim after the notifications page redesign replaced the checkbox table with per-event switches (https://github.com/mintlify/mint/pull/10773); events, defaults, and admin sections are otherwise unchanged, so no other docs edits were needed

Note

Low Risk
Documentation-only updates with no application or data-handling code changes.

Overview
Documents the dashboard Notifications settings page so org members can see how to control per-account email toggles for comments, suggestions, automation runs, and page feedback, including which categories are on or off by default and where admins manage Organization contacts (security and admin contact emails).

Adds dashboard/notifications to English navigation and introduces matching es, fr, and zh pages plus nav entries. Security contact setup instructions now point at the Notifications URL instead of the old security-contact settings path. Automations and editor collaboration docs gain short sections linking users to notification preferences for automation run emails and comment/suggestion mail.

Reviewed by Cursor Bugbot for commit 9ed8033. Bugbot is set up for automated code reviews on this repo. Configure here.

@mintlify

mintlify Bot commented Sep 1, 2026

Copy link
Copy Markdown
Contributor Author

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
mintlify 🟢 Ready View Preview Sep 1, 2026, 12:26 AM

@mintlify

mintlify Bot commented Sep 1, 2026

Copy link
Copy Markdown
Contributor Author

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
tomee 🟡 Building Sep 1, 2026, 12:25 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@mintlify

mintlify Bot commented Sep 5, 2026

Copy link
Copy Markdown
Contributor Author

Update from code changes updated this PR.

Made no changes; all best-practices checks passed

Source PRs

@mintlify

mintlify Bot commented Sep 5, 2026

Copy link
Copy Markdown
Contributor Author

Update from code changes updated this PR.

Made no changes; all checks passed

Source PRs

@ethanpalm
ethanpalm merged commit 13ad31c into main Sep 8, 2026
5 checks passed
@ethanpalm
ethanpalm deleted the mintlify/14ed552d branch September 8, 2026 22:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant