17.1. Creating Course Discussions

Discussions in an edX course include both course-wide topics of interest to all learners (such as “Feedback”, “Troubleshooting”, or “Technical Help”) as well as content-specific topics that you add to course units as discussion components. You create both types of discussion topics in Studio.

For information about creating discussion topics, see the following sections.

For information about creating discussions in which learners in a group such as a cohort or in a particular enrollment track only interact with posts from other learners in the same group, see About Divided Discussion Topics.

For information about running and moderating course discussions, see Running Course Discussions and Moderating Discussions.

17.1.1. Create Course-Wide Discussion Topics

All courses include a page named Discussion. When you create a course, a course-wide discussion topic named “General” is already included by default.

You can add additional course-wide discussion topics to guide how learners share and find information during your course. Such course-wide topics might include Introduction and Announcements, Feedback, or Troubleshooting. Discussions in these topics can begin as soon as your course is available.

Note

Make sure each discussion topic in your course has a unique name, whether it is a course-wide topic or a content-specific discussion topic that you add as a discussion component. If different discussion topics share the same name, learners might be confused as to which discussion topic they are participating in. For example, do not add a content-specific discussion topic named “General”, because a course-wide discussion topic named “General” already exists in every course.

To create a course-wide discussion topic, follow these steps.

  1. Open your course in Studio.

  2. Select Settings, then Advanced Settings.

  3. Scroll down to the Discussion Topic Mapping policy key. By default, its value looks like this.

    {
        "General": {
            "id": "course"
        }
    }
    
  1. Copy the three lines provided for the “General” topic and paste them above the closing brace character (}).

    {
        "General": {
            "id": "course"
        }
        "General": {
            "id": "course"
        }
    }
    
  2. Replace the second “General” with the quoted name of your new topic. For example, name the new topic “Questions about the Course”.

    {
       "General": {
           "id": "course"
       }
       "Questions about the Course": {
            "id": "course"
       }
    }
    
  3. Change the value for the second “id” to a unique identifier. For example, append a reference to the name of the topic.

    {
       "General": {
           "id": "course"
       }
       "Questions about the Course": {
            "id": "course_q"
       }
    }
    

    Note

    In discussion topic IDs, you can use only alphanumeric characters and these special characters: underscore, hyphen, and period.

  4. Add a comma after the first closing brace (},).

    {
       "General": {
           "id": "course"
       },
       "Questions about the Course": {
            "id": "course_q"
       }
    }
    
  5. Select Save Changes.

    Studio checks the syntax of your entry and reformats your entry to add line feeds and indentation.

  6. Scroll back to the Discussion Topic Mapping field to verify that your entry was saved as you expect. Entries that do not contain all of the required punctuation characters revert to the previous value when you save, and no warning is presented.

When learners select the Discussion page for your course, the drop-down Discussion list now includes the topic you added.

A new topic named Course Q&A in the list of discussion topics.

Note

To make a particular course-wide discussion topic the default topic when learners add new posts on the Discussion page, add a “default” attribute with a value of true to the topic’s definition.

{
   "General": {
       "id": "course"
   },
   "Questions about the Course": {
       "id": "course_q",
       "default": true
   }
}

Note

In courses that use cohorts, the course-wide discussion topics that you add are unified. All posts can be read and responded to by every learner, regardless of the cohort that they belong to. You can optionally configure these topics to be divided by cohort. For more information, see Specify Which Course-Wide Discussion Topics are Divided.

17.1.2. Create Content-Specific Discussion Topics

To create a content-specific discussion topic, you add a discussion component to a unit. Typically, you do this while you are designing and creating your course in Studio. Follow the instructions in Working with Discussion Components. The result is a discussion topic associated with a unit and its content. Learners can access content-specific topics both in the course unit and on the Discussion page.

Warning

Follow the recommended steps to add discussion components. Do not create discussion topics by using the Duplicate button in Studio, and do not reference the same discussion ID in more than one place in your course. Duplicated discussion components result in discussion topics that contain the same conversations, even if learners post in different discussion topics.

For information about the visibility of content-specific discussion topics, see Understanding When Learners Can See Discussion Topics.

Note

In courses with cohorts enabled, when you add discussion components to units in Studio, these discussion topics are by default unified. All learners in the course can see and respond to posts from all other learners. You can change content-specific discussion topics to be divided, so that only members of the same group can see and respond to each other’s posts. For information, see Content-Specific Discussion Topics and Groups.

17.1.3. Understanding When Learners Can See Discussion Topics

The names that you specify as the category and subcategory names for discussion components are not visible on the Discussion page in the LMS until after the course has started and the unit is released.

However, “seed” posts that you create in content-specific discussion topics before a course starts, or before the unit is released, are immediately visible on the Discussion page, even though the containing category or subcategory names are not visible. EdX recommends that you do not create posts in content-specific discussion topics before a unit is released. For more information about release dates and the visibility of components, see Controlling Content Visibility and Access.

In contrast, course-wide discussion topics that you create on the Advanced Settings page in Studio, including the default “General” discussion topic, are immediately visible, regardless of whether the course has started. They are not associated with any particular section or subsection of the course, and are not subject to release dates.

17.1.4. Allowing Learners to Make Anonymous Discussion Posts

By default, when learners participate in a discussion, their usernames are visible in the discussion. You can allow learners to make discussion posts that are anonymous to their peers: their usernames are not visible to other learners. Their usernames will still be visible to course staff.

To allow anonymous discussion posts in your course, follow these steps.

  1. In Studio, select Settings, then select Advanced Settings.
  2. Locate the Allow Anonymous Discussion Posts to Peers field. The default value is false.
  3. Change the value of the setting to true.
  4. Select Save Changes.

Learners can now create discussion posts in your course that are anonymous to other learners.

Note

The Advanced Settings page in Studio includes another field named Allow Anonymous Discussion Posts. Setting the value of that field to true enables learners to create discussion posts that are anonymous to course staff, as well as to other learners. As a best practice, edX recommends that you do not set this field to true.

17.1.5. Discussions in the edX Mobile App

Learners can participate in course discussions using the edX mobile app as they do on the edX site, but there are some differences in the actions that moderators can take in discussions using the mobile app. To perform moderation or administrative tasks for your course discussions, you need to work in a web browser.

The following actions are not supported on the edX mobile apps.

  • Pinning posts
  • Marking responses to question posts as answers
  • Endorsing responses to discussion posts
  • Closing posts