Composer Popup Messages Guide

[Discourse]

This guide explains the various composer messages that can appear, their relevant site settings, and how to disable them.

Required user level: Administrator

In Discourse, you might notice that certain popup messages appear when users are composing posts.

These messages, known as composer education messages, serve educational and moderation purposes, guiding users on best practices and reminding them of community guidelines.

In this guide, we’ll explain the details and context about each composer message, and how to turn off these popups if desired.

Detailed composer messages and associated site settings

Below is a comprehensive list of composer education messages, their associated text key, their related site settings, the conditions under which they appear, and the default message they display:

New user education messages

Educate New Topic

This message appears the first time a user starts a new topic.

• Text key: education.new-topic
• Site setting: educate until posts
  • Determines how many of a user’s initial posts will trigger the display of the new user education panel in the composer.
• Message:

Welcome to %{site_name} — thanks for starting a new conversation!

• Does the title sound interesting if you read it out loud? Is it a good summary?

• Who would be interested in this? Why does it matter? What kind of responses do you want?

• Include commonly used words in your topic so others can find it. To group your topic with related topics, select a category (or tag).

For more, see our community guidelines. This panel will only appear your first %{education_posts_text}.

Educate New Reply

This message appears the first time a user replies to a topic.

• Text key: education.new-reply
• Site setting: educate until posts
  • Determines how many of a user’s initial posts will trigger the display of the new user education panel in the composer.
• Message:

Welcome to %{site_name} — thanks for contributing!

• Be kind to your fellow community members.

• Does your reply improve the conversation?

• Constructive criticism is welcome, but criticize ideas, not people.

For more, see our community guidelines. This panel will only appear for your first %{education_posts_text}.

Limited replies for new users

This message appears when a new user reaches their reply limit for a single topic.

• Text key: education.too_many_replies
• Site setting: newuser max replies per topic
  • Sets the maximum number of replies a new user can make in a single topic until someone else replies to them.
• Message:

You have reached the reply limit for this topic

We’re sorry, but new users are temporarily limited to %{newuser_max_replies_per_topic} replies in the same topic.

Instead of adding another reply, please consider editing your previous replies, or visiting other topics.

Avatar update prompt

This prompt suggests that the user sets a profile picture after participating in a few topics and replies.

• Text key: education.avatar
• Site setting: disable avatar education message
  • When enabled, it disables the message that educates users about changing their avatar.
• Message:

How about a picture for your account?

You’ve posted a few topics and replies, but your profile picture isn’t as unique as you are – it’s just a letter.

Have you considered visiting your user profile and uploading a picture that represents you?

It’s easier to follow discussions and find interesting people in conversations when everyone has a unique profile picture!

Sequential replies warning

This message appears when a user makes several consecutive replies in a topic.

• Text key: education.sequential_replies
• Site setting: sequential replies threshold
  • Specifies the number of sequential posts a user must make in a topic before being reminded that they have made too many sequential replies.
• Message:

Consider replying to several posts at once

Rather than several replies to a topic in a row, please consider a single reply that includes quotes from previous posts or @name references.

You can edit your previous reply to add a quote by highlighting text and selecting the quote reply button that appears.

It’s easier for everyone to read topics that have fewer in-depth replies versus lots of small, individual replies.

Dominating the topic

This message encourages users to allow others to participate when they post too frequently in a topic.

• Text key: education.dominating_topic
• Site setting: dominating topic minimum percent
  • Indicates the percentage of posts a user must have in a topic before they are reminded about overly dominating the discussion.
• Message:

You’ve posted a lot in this topic! Consider giving others an opportunity to reply here and discuss things with each other as well.

Get a room prompt

This message suggests switching to personal messages if a user is having a prolonged back-and-forth with another user.

• Text key: education.get_a_room
• Site setting: get a room threshold
  • Defines the number of posts a user can make to the same person in a topic before being warned to “get a room” and consider other participants.
• Message:

one: “You’ve replied to @%{reply_username} once, did you know you could send them a personal message instead?”

other: “You’ve replied to @%{reply_username} %{count} times, did you know you could send them a personal message instead?”

Don’t feed the trolls

This message warns users about replying to flagged posts which might encourage negative behavior.

• Text key: education.dont_feed_the_trolls
• Site setting: don't feed the trolls threshold
  • Specifies the number of flags from other users that a post must receive before triggering a warning message to the user.
• Message:

This post has already been flagged for moderator attention. Are you sure you wish to reply to it? Replies to negative content tend to encourage more negative behavior.

Reviving an old topic warning

This message appears when a user attempts to reply to an old topic.

• Text key: education.reviving_old_topic
• Site setting: warn reviving old topic age
  • Sets the age threshold (in days) for displaying a warning when someone starts replying to an old topic. If set to 0, the warning is disabled.
• Message:

Revive this topic?

The last reply to this topic was %{time_ago}. Your reply will bump the topic to the top of its list and notify anyone previously involved in the conversation.

Are you sure you want to continue this old conversation?

Similar Topics

This message appears when a user attempts to create a topic similar to another existing topic.

• Text key: js.composer.similar_topics
• Site settings:
  • min_title_similar_length
    • This setting determines the minimum length a title must have before it is checked for similar topics. If the title length is below this threshold, the check for similar topics will not occur.
  • max_similar_results
    • This setting specifies the number of similar topics to display above the editor when a user is composing a new topic. The comparison is based on both the title and body of the new topic. If set to 0, the similar topic messages will be disabled.
  • min_title_similar_length
    • This setting defines the minimum number of topics that must exist before similar topics are suggested when composing new topics.
• Message:

Your topic is similar to…

[Example Topic 1]

[Example Topic 2]

…

Disabling composer popups

Using CSS

Here’s how you can disable all composer education messages by using CSS:

1. Open your site’s admin panel.

2. Navigate to the “Appearance → Themes” section of your site. (/admin/customize/themes)

3. Add the following CSS code to your theme:

   /* Hide all composer education messages */
   .composer-popup {
       display: none;
   }
   

4. Save the changes.

This code will hide all composer education messages across your site.

Adjusting Site Settings

If you prefer to only disable specific messages, you can adjust the relevant site settings instead.

Alternately, you can edit the contents of the pop up message from your .../admin/customize/site_texts page.

Last edited by @SaraDev 2024-09-18T18:46:44Z

Check document

Perform check on document: