Creating quick access links to Discourse preference pages

:bookmark: This guide explains how to create easy-to-use links that direct users to specific sections of their Discourse preferences. These links work for any user on your Discourse instance.

:person_raising_hand: Required user level: All users

Navigating to specific sections of user preferences in Discourse can be made easier with relative links. These links are universal and will work for any user on your Discourse instance. Here’s how to create and use these handy links.

Creating relative links to preference pages

You can use the relative links to direct users to specific sections of their preferences:

Check the available preferences on your site to see which quick links are accessible.

Using the links in Markdown

To create these links in your posts, use the following Markdown:

* [Account](/my/preferences/account)
* [Emails](/my/preferences/emails)
* [Notifications](/my/preferences/notifications)

Copy and paste the above Markdown into your post, and the links will be automatically created.

Sending links via email

When sending a link to a user’s preferences via email, you’ll need to use an absolute URL. Here’s an example for the Account preferences:

Hello,

You can quickly navigate to your Account preferences by clicking the following link:
[Account Preferences](https://discourse.example.com/my/preferences/account)

Best,
Your Name

:warning: Remember to replace https://discourse.example.com with your own forum’s URL.

Last edited by @maiki 2025-01-15T20:51:55Z

Last checked by @hugh 2024-07-02T05:27:42Z

Check documentPerform check on document:
13 Likes

The “categories” example doesn’t seem to work anymore.

3 Likes

/tags still works, but the menu isn’t available from the interface anymore. I think it’s a remnant, and that /categories and /tags have been merged into /my/preferences/tracking Tracking

2 Likes

Check this link that is at the bottom of the first post here. Seems they need to update the Op post

Tags and Categories us under “Tracking”

Covers Topics, Categories & Tags all in one.

- [Tracking](/my/preferences/tracking)

Result

1 Like

I’ve updated the following section:

Plugins and site settings may determine different preferences available to a user, so I reduced the examples and noted folks can check their site’s preferences to figure out which quick links are available.

5 Likes