New User Tips

In the latest beta of Discourse, we introduced user tips explaining the most important features of Discourse (enabled by default; to disable it, navigate to your site setting and search for “enable new user tips”).

At this moment, there are user tips for:

  • first notification
  • topic timeline
  • post menu
  • topic notification level
  • suggested topics

:camera_flash: Screenshots


  • The previous “first notification” tutorial was replaced by the new one (before / after):

  • Users can hide all tips from showing them in the future by pressing the don’t show me these tips button.

  • Users can show again all their user tips by going to their preferences and clicking the Show user tips again button.


My favorite new feature this year. Nice work :raised_hands:


How can I translate it to spanish? Thanks!


I think they’ll be translated along with the other core content in due time, but they’re all grouped under js.popup js.user_tips if you want to get a head start and change them for your site on the /admin/customize/site_texts page. :+1:


Generally via Contribute a translation to Discourse but for the next one or two months you can’t contribute for spanish, you can only translate locally for your site if needed, as Jammy suggested.

Spanish translation, along with other common languages, is currently under translation and proofreading by a translation agency and translations are pushed into Discourse once a week. See Translation and proofreading disabled for some languages for details.


Awesome feature!
Discourse offers so many functionalities that this type of tips will be very helpful.


With the latest update of Discourse, we have added three more user tips. Existing users will not see the tips unless you hit the Show user tips again button from :gear: Preferences → Interface.

What do you think?


It’s brilliant. We enabled it recently and it really helps a ton.
On Software AG Tech Community & Forums we used a bit of css to add an image and make it more sweet:

Is there any way we can get involved and help to add more tips, i.e. submit pull requests. I can immediately think of several functionalities that can be added as most people would miss them.


If you add your suggestions here they’ll definitely be considered. :slight_smile: :+1: Which features did you have in mind?


hi, can I make the background of the first notification dark as before and make it mandatory to click on the notification?

First Notification the background


Here are several I can think of :slight_smile:

  • That avatars on the topic lists are clickable and then you can click the user name/avatar again, which will show much more information
  • The search button in the top navigation and the search filtering options
  • User settings and preferences (they are a lot) (when logged in)
  • Category/tag notifications button with the bulb (when logged in)
  • Quoting functionality
  • Mention functionality

Maybe here it could also say that clicking on the top date will jump to the first post, and clicking on the bottom date to the latest reply (I think few people know about this feature).


any way to override this for all my community? I wanna put them all through the user tips again no matter how long they’ve been on board :slight_smile:


Check out: Edit a user preference for everyone or a subset of users


don’t have rails access to my discourse instance… was hoping for a “show new user tips once for all users who’ve never seen them” setting :slight_smile:


How has this experiment been going for sites that have been using it? I think we will want to soon remove the “experimental” part and start enabling it by default on all new sites.

Personally, I am very happy with it and it works well, so I think we can go ahead and make it official as a v1, even while we work on a v2 with additional tips or improvements.

I did just test it out by spinning up a new basic plan site on our hosting, which has it enabled by default, and noticed a few things to consider for v2:

  1. The “Your first notification!” user tip does not always appear. I like it because it makes sense as the very first one and is very prominent! The issue is, I think, that not all configurations result in a notification appearing immediately, as soon as the user first logs in. Personally I think we should always show it, whether or not the user has any notifications. But then we have to change the uer tip title from “Your first notification!” to something else like “Your Notifications are here”.

  2. The first one to appear in fact is the one at the very bottom of the page after clicking into a post and reading it: " Keep reading! Here are some topics we think you might like to read next." After this tip I am shown three more in quick succession, immediately. Topic timeline first, then the post menu, then notification levels. I think the order could be changed to 1) topic timeline, 2) post menu, 3) notification levels, 4) keep reading.

  3. Visually I like the user tips very much, but I think they would be more effective if they were more “in your face”, maybe bigger and using a more opinionated color and design. Right now they are small enough and match the design, so it is possible to not notice them right away and just ignore them. It’s also possible to miss the feature the user tip is pointing to and seeking to teach you about, because the arrow is small and subtle. And finally, they also just “appear” and there is no animation to draw attention to it.

  4. If you do follow (1) and click the link to your discobot tutorial PM, then you will start to get (2) the rest of your user tips all at once. This feels overwhelming, just at the moment when discobot is asking you to do some things.

  5. There is no way back to the user tips later, by existing users or by a new user who maybe accidentally turned them off. There is a way via the user prefs but that is buried. I’m not quite sure what the answer is for this yet but a UI to “get help” with features currently on the the page would be great to start thinking about.

And finally, I have noticed that on many other sites with new user tips there is a “beginning, middle and end” to the sequence of user tips. There is also often a progress indicator to give the user a modicum of control, by showing which tip the user is on and how many more there are to see before it is over. You can also restart it.

Here’s an example from a medical site I was asked to join by my gastroenterologist. The design is hideous, but is opinionated and hard to ignore. Note that it starts with a “Welcome” popup front and center, each tip has a dot indicating how many more tips are still to be shown, and it ends with a “Congrats” popup indicating it is done. And finally, when you acknowledge and close the congrats popup you are looking at a post containing more information about the site and a video you can watch to learn more.

I realize that user tips are displayed for things that are not on the page so the sequence in the screen recording won’t translate perfectly.


We’re using them for some time and I haven’t noticed any particular issues with the tips. Except that I’d like to have more tips :smiley: - they are quite limited still.
Apart from that I agree with your notes above, especially (2), (3), (4)

1 Like

Nice! Thanks for the feedback. If you can provide title and text for more tips you’d like to see please do so! It helps to have the full copy for the user tip because coming up with easy to grasp text is hard. Also when you propose tips, please explain why you think it is needed and when you think it should be shown.

Do we have any SQL-query or something to find out how many have used new user tips?

Because if most of new users don’t use it we don’t know if it works, or if it useful as it is.

1 Like

Do you have user tips enabled on your site? For the moment it’s experimental and off by default. If you enable it, every new user to your site will see it, unless they select “don’t show me these tips”. Existing users can opt to display them via their user prefs. See the OP for details.

1 Like