Add link from ‘Auto silence first post regex’ description to Watched words

zogstrip · May 21, 2026, 2:10pm

The link will be added once this PR gets merged

github.com/discourse/discourse

UX: Link admin pages from related site setting descriptions (#40222)

main ← link-admin-pages-in-site-setting-descriptions

merged 02:12PM - 21 May 26 UTC

ZogStriP

+3 -3

Several site setting descriptions reference an admin page by name but leave the …reference as plain text, forcing admins to navigate manually to act on the description's advice. For example, the `auto_silence_first_post_regex` description tells admins to "Use Silence Watched Words instead" without linking to the watched words admin page; `use_admin_ip_allowlist` ends with the textual breadcrumb "(Admin > Logs > Screened Ips)" rather than a link; and `backup_location` mentions "Files settings" with no way to jump there. Wrap those references in `<a href='%{base_path}/...'>...</a>` so they render as clickable links. The rendering pipeline already supports this: `SiteSettings::LabelFormatter.description` interpolates `%{base_path}` via `I18n.t`, and the admin UI renders the description via `{{trustHTML @description}}` in `frontend/discourse/admin/components/site-settings/description.gjs`. Existing entries such as `default_locale`, `contact_email`, and `content_security_policy_frame_ancestors` already use the same pattern, so no rendering changes are needed. The `use_admin_ip_allowlist` entry also drops the trailing "(Admin > Logs > Screened Ips)" breadcrumb, which becomes redundant once the phrase itself is a link. https://meta.discourse.org/t/403058

Topic		Replies	Views
Add links to meta.discourse.org instructions inside admin Feature	8	2087	October 15, 2018
Move auto silence first post regex to the Watched Words section Feature watched-words	5	1439	December 1, 2021
Connecting site settings to documentation Feature site-settings	5	119	December 30, 2025
Include more hints throughout Discourse that link to relevant Docs on Meta UX	4	461	April 19, 2025
How do I add links to site settings into the settings description of my component? Development	5	156	June 16, 2025

Add link from ‘Auto silence first post regex’ description to Watched words

Related topics