Composer Popup Messages Guide

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

:person_raising_hand: 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:

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:

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:

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:

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:

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:

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:

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:

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:

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:

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 documentPerform check on document:
5 Likes