Skip to main content
Ctrl+K
 Latest documentation - Home

User Home Pages

  • Community
    • Open edX Platform Release Notes
      • Sumac: The Current Release
        • Sumac Release Notes
        • Sumac Developer & Operator Release Notes
      • Teak: June 2025 Release
        • Teak Release Notes
        • Teak Developer & Operator Release Notes
      • Ulmo: December 2025 Release
        • Ulmo Release Notes
        • Ulmo Developer & Operator Release Notes
      • Unsupported Open edX Releases
        • Open edX Redwood Release
        • Open edX Quince Release
        • Open edX Palm Release
        • Open edX Olive Release
        • Open edX Nutmeg Release
        • Open edX Maple Release
        • Open edX Lilac Release
        • Open edX Koa Release
        • Open edX Juniper Release
        • Open edX Ironwood Release
        • Open edX Hawthorn Release
        • Open edX Ginkgo Release
        • Open edX Ficus Release
        • Open edX Eucalyptus Release
        • Open edX Dogwood Release
        • Open edX Cypress Release
        • Open edX Birch Release
      • Site Operators: Named Release Branches and Tags
    • What is the Open edX Product Roadmap?
    • How to Read the Product Roadmap
    • Open edX Security Policy
    • Receive Open edX Platform Announcements by Email
  • Educators
    • Accessibility
      • Open edX® Accessibility Guidelines
      • Accessibility Best Practices Checklist
      • Designing Your Course For a Mobile Experience
      • Manage Video Transcripts
    • Advanced Features
      • About Learner Cohorts
      • Manage Course Cohorts
      • Best Practices for Cohort Assignment Strategies
      • Offering Different Content to Different Learner Groups
      • Guide to Creating Cohort-Specific Course Content
      • About Content Groups
      • Manage Content Groups
      • Associate Cohorts with Content Groups
      • View Cohort-Specific Course Content
      • About Content Experiments
      • About Group Configurations
      • Manage Content Experiments
      • Add a Content Experiment in OLX
      • Set Up Group Configuration for OLX Courses
      • Randomize Units for Assessment (Exams) or Variable Content Sharing
      • Guidelines for Modifying Group Configurations
      • Experiment Group Configurations
      • Test Content Experiments
      • About Teams
      • Teams Configuration Options
      • Manage Teams
      • Manage Team Memberships via CSV Upload
      • Connect Teams to Content Groups
      • About Managing Teams Discussions
      • The Learner’s Experience of Teams
      • Using Open edX as an LTI Tool Provider
      • Reusing Course Content with LTI
      • Planning for Content Reuse (LTI)
      • Create a Duplicate Course for LTI use
      • Determine Content Addresses when using Open edX as an LTI Provider
      • Use Open edX Platform as an LTI Provider to Canvas (Example)
      • Use Open edX Platform as an LTI Provider to Blackboard (Example)
      • Build a taxonomy using a template
      • Import and Export A Taxonomy
      • Create a flat taxonomy by uploading a CSV
      • Update/Re-import a taxonomy
      • Why does each tag need an ID when importing a taxonomy?
      • Manage Permissions on a Taxonomy
      • Add and delete tags on courses
      • Add and delete tags on course content
      • Export tag data from a course
      • Annotation Problem
      • Calculator Tool
      • Embed a Google Calendar in Your Course
      • Enable the Google Drive Files Tool
      • Add a Google Drive File to Your Course
      • About the Notes Tool
      • Recommender Tool
      • Use a Section from a Course independently of the Course Outline
      • Add Custom CSS or JavaScript Code to a Course
    • Components & Activities
      • About Problems, Exercises, and Tools
      • Guide to Problem Types
      • Working with Problem Components
      • Guide to Problem Settings
      • Gradebook Assignment Types
      • Best Practices for Providing Feedback
      • Adding Feedback and Hints to a Problem
      • Configure a Hint in a Problem
      • Awarding Partial Credit for a Problem
      • Set the Assignment Type and Due Date for a Subsection
      • Adding Tooltips to a Problem
      • The Advanced Editor
      • Add Hints via the Advanced Editor
      • Modifying a Released Problem
      • The Learner View of a Problem
      • Add Unsupported Problem Types and Exercises
      • Add a Chemical Equation Problem
      • Guide to Chemical Equation Problem XML
      • Add a Circuit Schematic Builder Problem
      • About the Completion Tool
      • Enable the Completion Tool
      • Add the Completion Tool to an OLX Course
      • Guide to Custom JavaScript Display and Grading Problem
      • Create a Custom JavaScript Display and Grading Problem
      • About Custom Python-evaluated Input Problem
      • Guide to the Custom Python-Evaluated Input Problem
      • Create a Custom Python-Evaluated Input Problem
      • About the Drag and Drop Problem
      • Guide to the Drag and Drop Problem
      • Create a Drag and Drop Problem
      • Dropdown Problem
      • Add a Dropdown Problem
      • Use Feedback in a Dropdown Problem
      • Use Hints in a Dropdown Problem
      • Dropdown Problem OLX Reference
      • Enable Additional Exercises and Tools
      • About External Grader Problems
      • External Grader Problem Requirements
      • Add an External Grader Problem in Studio
      • Gene Explorer Tool
      • About Image Mapped Input Problem
      • Create an Image Mapped Input Problem
      • Image Mapped Input Problem XML
      • About the LTI Component
      • LTI Component Settings
      • Enable LTI Components for a Course
      • Set Up an LTI 1.1 Component
      • Set Up an LTI 1.3 Component
      • Enable and Use LTI Advantage Features
      • About the Math Expression Input Problem
      • Add a Math Expression Input Problem
      • Math Expression Input Problem OLX Reference
      • Multiple-Choice Problem Type
      • About Multi-select Problem
      • Add a Multi-select (Checkbox) Problem
      • Edit Multi-select Problems using the Advanced Editor
      • Award Partial Credit
      • Multi-select Problem OLX Reference
      • About Numerical Input Problem
      • Manage a Numerical Input Problem
      • Award Partial Credit in a Numerical Input Problem
      • Add a Single Select and Numerical Input Problem
      • Numerical Input Problem OLX Reference
      • Problem Written in LaTeX
      • Work with LaTeX Code
      • About Open Response Assessments (ORA)
      • Create an Open Response Assessment Assignment
      • Managing Open Response Assessment Assignments
      • Access Metrics for ORA Assignments
      • Staff Grading for Open Response Assessments
      • Oppia Exploration Tool
      • About the Peer Instruction Tool
      • Adding a Peer Instruction Assignment in Studio
      • Periodic Table Tool
      • Enable the Poll Tool
      • Add a Poll in Open edX Studio
      • Problem with Adaptive Hint
      • Problem with Adaptive Hint XML
      • About Proctored Exams
      • Preparing Learners for Proctored Exams
      • Enable Proctored Exams
      • Manage Proctored Exams
      • Online Proctoring Rules for Learners
      • Allow Opting Out of Proctored Exams
      • Create a Proctored Exam with Proctortrack
      • Create a Proctored Exam with RPNow
      • View Proctored Session Results with Proctortrack
      • View Proctored Session Results with RPNow
      • Guide to Interpreting the Proctored Exam Results Report
      • Guide to Interpreting the Proctored Exam Results Report
      • Protex Protein Builder Tool
      • Randomized Content Blocks
      • Use Randomized Content Blocks
      • About Single Select Problems
      • Add a Single Select Problem
      • Award Partial Credit in a Multiple Choice Problem
      • Add a Single Select and Numerical Input Problem
      • Edit Single Select Problems using the Advanced Editor
      • Single Select Problem OLX Reference
      • Manage Staff Graded Assignment
      • About Text Input Problem
      • Add a Text Input Problem
      • Edit Text Input Problems using the Advanced Editor
      • Text Input Problem XML Reference
      • About Timed Exams
      • Manage Timed Exams
      • Zooming Image (Dual Image) Tool
    • Content Creation & Management
      • About Course Units
      • Manage Course Units
      • Set Access Restrictions For a Unit
      • Copy and Paste Course Units
      • Hide a Unit from Learners
      • Copy and Paste Course Components
      • The Unit Workflow
      • About Course Components
      • Manage Course Components
      • Restrict Access to a Component
      • Components that Contain Other Components
      • About Text Components
      • Work with the Text Editor
      • Work with HTML Code in the Text Component
      • Work with LaTeX Code
      • Adding MathJax to Text Components
      • Manage the Full Screen Image Tool
      • Guide to Course Video
      • Manage Video Components
      • Video Process Overview
      • Troubleshooting Video Problems
      • Video Technical Specifications
      • Add an In-Video Quiz
      • Guide to Controlling Content Visibility and Access
      • Manage Subsection Prerequisites
      • Manage Course Files
      • Manage Custom Pages
      • Add Course Textbooks
      • Configuring Applications & Resources
      • Guide to the Files Page
      • Enabling the Notes Application
      • Enabling the Teams Application
      • Enable the Wiki Application
      • Enable the Calculator Resource
      • MathJax for Mathematics
      • Conditional Module
      • SCORM Overview
      • Manage SCORM Content
      • About the Google Drive Files Tool
      • Enable the Google Drive Files Tool
      • Add a Google Drive File to Your Course
      • About the Iframe Tool
      • Create an IFrame Tool
      • Embed an iframe in the Text Editor
      • Navigate the Library Homepage
      • Use content sidebars to manage content
      • Create and edit content in a Library
      • Publish Library content
      • Add and Delete tags in Library content
      • Build a Collection in a Library
      • Search for content in a Library
      • Add users to Libraries
      • Add Library content to a course
      • Add a Problem Bank to your course for randomization
      • Sync a Library update to your course
      • Legacy Content Libraries v1 Overview
      • Create a New Legacy Library
      • Edit a Legacy Library
      • Add Components to a Legacy Library
      • View the Contents of a Legacy Library
      • Edit Components in a Legacy Library
      • Delete a Legacy Library
      • Give Other Users Access to Your Legacy Library
      • Exporting and Importing a Legacy Library
      • Leveraging Legacy Libraries
      • Course Outline Terminology in Exported Files
      • Working with the .tar.gz File
      • Guide to Testing Your Course Content
      • Guide to Role-Specific Course Views
      • View Published and Released Content
      • Preview Draft Content
    • Creating a Course in Open edX®
      • Instructional Design Overview
      • Instructional Design Templates
      • The Course Development Process
      • What Is the LMS?
      • What Is Studio?
      • About the Course Outline
      • The Dashboard, Profile, and Account Pages
      • What is the Programs Page?
      • Guide to Basic Course Details
      • Create a New Course in Studio
      • Edit Basic Course Details
      • Guide to Course About Page (Schedule & Details)
      • Edit the Course About Page
      • Set Course Pacing
      • Set the Course Run Schedule
      • Add Course Metadata
      • Guide to Course Content Development
      • Create a New Course in Studio
      • About the Course Outline
      • Manage Course Outline
      • Modify Settings for Objects in the Course Outline
      • Publish Content from the Course Outline
      • About Course Sections
      • About Course Subsections
      • About Course Units
      • Manage Course Sections
      • Manage Course Subsections
      • Manage Course Units
      • View As Learner
      • Add Text
      • Manage Video Components
      • Add a Single Select Problem
      • Resources for Open edX Course Teams
      • Guide to Course Team Roles
      • Add Course Team Members
      • Manage Course Beta Testing
      • About Graded Subsections
      • Set the Grace Period
      • Set the Grade Range
      • The Learner View of Grades (Progress Page)
      • About Certificates
      • Manage Course Certificates
      • Edit Course Certificates
      • Configure Certificate Availability and Timing
      • Manage Course Badges
      • Require a Prerequisite Course
      • Require an Entrance Exam
      • Guide to Course Licenses
      • Set Course Content Licensing in Studio
      • About Course Beta Testing
      • Manage Course Beta Testing
      • Course Launch Checklist
      • Share Course Content on Social Media Platforms
      • Enrollment Requirements
      • Manage Course Enrollments
      • View Course Enrollments
      • View Learners Not Yet Enrolled
      • Export a Course
      • Import a Course
      • Guide to Course Reruns
      • Re-Run a Course
    • Data & Analytics
      • View Course Information
      • View Course Enrollments
      • View Learners Not Yet Enrolled
      • About Learner Data
      • View Learner Data
      • View Anonymized Learner IDs
      • Guide to Staff Debug Info
      • Guide to the Student Profile Report
      • View Learner Grades
      • Manage Learner Grades
      • Guide to the Progress Page
      • Guide to the Grade Report
      • Guide to the Problem Grade Report
      • View Answer Data
      • Frequently Asked Questions about the Student Answer Distribution Report
      • View Certificate Data
      • Guide to the Certificate Report
    • Learner Engagement & Communication
      • About Course Discussions
      • Best Practices for Configuring Course Discussions
      • Configure Open edX Discussions
      • Configure Open edX Discussions - Legacy
      • Best Practices for Moderating Course Discussions
      • Assign Discussion Moderation Roles
      • Moderate Discussions
      • Toggle Anonymous Discussion Posts
      • A Learner’s View of the Discussion
      • About Divided Discussions
      • Set Up Divided Discussions
      • Setting up Discussions in Courses with Cohorts
      • Guide to Managing Divided Discussions
      • Guide to Bulk Email Messages
      • Send an Email Message to Course Participants
      • Review Sent Messages
      • Example Messages to Learners
      • Guide to Composing Email Messages
      • View Email Task History Report
      • Guide to Automatic Email Messages
      • Manage Course Highlight Emails
      • About Course Updates and Handouts
      • Add Course Updates and Handouts
      • About the Course Wiki
      • Manage the Course Wiki
      • Contribute to the Course Wiki
      • Course Live
      • Google Calendar Tool
      • Embed a Google Calendar in Your Course
      • Collapse and expand the navigation sidebar
      • Enable the Poll Tool
      • Add a Poll in Open edX Studio
      • Guide to the Poll Tool via OLX
      • Create a Poll (via OLX)
      • Manage Survey Tool
      • Manage the Survey Tool via OLX
      • Manage the Word Cloud Tool
    • OLX
      • Read Me
      • What is Open Learning XML?
      • Getting Started with OLX
      • What is the OLX Course Structure?
      • Create OLX Course Policies
      • Create OLX Grading Policy
      • Create the Course Asset Policy in OLX
      • Create Course Assets in OLX
      • Create Course Overview in OLX
      • Create Short Description in OLX
      • Create Course Tabs in OLX
      • OLX Course Building Blocks
      • The OLX Courseware Structure
      • HTML Components in OLX
      • Discussion Components in OLX
      • Video Components in OLX
      • Problem Components in OLX
      • Annotation Problem
      • Guide to Chemical Equation Problem XML
      • Add a Circuit Schematic Builder Problem
      • About the Completion Tool
      • Conditional Module
      • Guide to Custom JavaScript Display and Grading Problem
      • About Custom Python-evaluated Input Problem
      • About the Drag and Drop Problem
      • Dropdown Problem OLX Reference
      • Manage the Full Screen Image Tool
      • Gene Explorer Tool
      • Enable the Google Drive Files Tool
      • Add a Google Drive File to Your Course
      • Create an IFrame Tool
      • Image Mapped Input Problem XML
      • About the LTI Component
      • Math Expression Input Problem OLX Reference
      • Adding MathJax to Text Components
      • Multi-select Problem OLX Reference
      • Manage a Numerical Input Problem
      • About Open Response Assessments (ORA)
      • Create an Open Response Assessment Assignment
      • Managing Open Response Assessment Assignments
      • Staff Grading for Open Response Assessments
      • Access Metrics for ORA Assignments
      • Periodic Table Tool
      • Guide to the Poll Tool via OLX
      • Create a Poll (via OLX)
      • Problem Written in LaTeX
      • Problem with Adaptive Hint
      • Protex Protein Builder Tool
      • Recommender Tool
      • About Single Select Problems
      • Add a Single Select and Numerical Input Problem
      • Manage the Survey Tool via OLX
      • Symbolic Response
      • About Text Input Problem
      • Manage the Word Cloud Tool
      • Zooming Image (Dual Image) Tool
      • About Content Experiments
      • Guidelines for Modifying Group Configurations
      • Manage Content Experiments
      • Add a Content Experiment in OLX
      • Test Content Experiments in OLX
      • Example of an OLX Course
        • The OLX Structure of a Sample Course
        • The edX-Insider course.xml File
      • The OLX Structure of a Sample Course
      • The edX-Insider course.xml File
      • Example of OLX for a Studio Course
        • The Structure of the Manual Testing Course
      • The Structure of the Manual Testing Course
  • Learners
    • Welcome!
    • Exploring Your Dashboard and Profile
    • View Course Sections from the Navigation Sidebar
    • Enrolling in a Course
    • Completing Course Prerequisites
    • Accessing Course Content and Information
    • Starting a Course
    • Checking Your Progress in a Course
    • Getting a Course Certificate or Badge
    • Watching Videos on the Open edX Video Player
    • Participating in Course Discussions
      • Anatomy of Course Discussions
      • Exploring Discussion Posts
      • Taking Part in Course Discussions
      • Keeping Up with New Activity
      • Providing Feedback on Contributions
    • Completing Different Types of Assignments
      • Completing Mathematical and Scientific Assignments
      • Taking a Timed Exam
      • Proctored Exams
      • Explaining Multiple Choice Answers
    • Completing Essay Assignments
    • Using Google Files and Calendars in Your Course
    • Working on Team Projects and Activities
    • Searching the Course
    • Bookmarking Course Content
    • Taking Notes in an Open edX Course
    • Notifications & Preferences
    • Using the Course Wiki
    • Understanding How Courses and Videos Are Licensed
    • Read Me
    • About the Course Dashboard
    • Share Your Courses on Social Media
    • About the User Profile Page
    • Add or Update a Limited Profile
    • Add or Update a Full Profile
    • Add Links to Your Personal Social Media Accounts
    • View Another Learner’s Profile
    • Update Course-Specific Settings
    • Resources for Open edX Learners
  • Site Operators
    • Installing, Configuring, and Running the Open edX Platform
      • General Information
        • Read Me
        • Getting Help
        • Open edX Browser Support
      • Open edX Platform Releases
        • Open edX Latest Platform Release
        • Open edX Olive Release
        • Open edX Nutmeg Release
        • Open edX Maple Release
        • Open edX Lilac Release
        • Open edX Koa Release
        • Open edX Juniper Release
        • Open edX Ironwood Release
        • Open edX Hawthorn Release
        • Open edX Ginkgo Release
        • Open edX Ficus Release
        • Open edX Eucalyptus Release
        • Open edX Dogwood Release
        • Open edX Cypress Release
        • Open edX Birch Release
      • Installing and Starting the Open edX Platform
        • Open edX Tutor Installation
      • Configuring the Open edX Platform
        • Guidelines for Updating the Open edX Platform
        • Configuring Open edX Sites
        • Changing the Appearance of Open edX Sites
        • Adding Custom Fields to the Registration Page
        • Specifying Allowed Registration Email Patterns
        • Adding the CourseTalk Widget
        • Enabling Open edX Search
        • Enabling Course Certificates
        • Enabling Self-Paced Courses
        • Enabling Public Course Content
        • Enabling Custom Courses
        • Enabling Custom Course Settings
        • Enabling Discussion Notifications
        • Enabling Entrance Exams
        • Configuring Open Response Assessments
        • Enabling Course Prerequisites
        • Enabling Course and Video Licensing
        • Configuring Transcript Behavior
        • Configuring an edX Instance as an LTI Tool Provider
        • Enabling Social Sharing of Courses and Certificates
        • Configuring a Password Policy
        • Enabling Third Party Authentication
        • Enabling Timed Exams
        • Setting Up the YouTube API Key
        • Installing an XBlock
        • Enabling a CDN for Course Assets
        • Enabling the Weekly Learning Goals Feature
        • Retrieving Extended Profile Metadata
      • Open edX Analytics Options
      • Adding ECommerce to Open edX
      • Setting Up the Open edX Mobile Applications
      • Index of Open edX Feature Flags
      • Glossary
      • Adding E-Commerce (Deprecated) to the Open edX Platform
        • Install and Start the E-Commerce Service
        • Comprehensive Theming
        • Manage Static Assets
        • Create E-Commerce Products
        • Enable the E-Commerce Service Receipt Page
        • Manage Orders
        • Test Your E-Commerce Application
        • Additional E-Commerce Features
        • Internationalization
      • Adding edX Insights (Deprecated)
        • Options for Installing edX Insights (Deprecated)
        • Using Elastic MapReduce on AWS
      • Deprecated Open edX Mobile Applications
    • Site Operators: Quick Start
    • Site Operators: How-tos
      • How to Enable a Waffle Flag for a User
      • Configuring Site-Wide Analytics Tools
      • Enabling Public Course Content
      • Configuring Google Analytics
      • Use A Frontend Plugin Framework Slot
    • Site Operators: Concepts
    • Site Operators: References
      • Available Frontend Plugin Slots
  • Developers
    • Maintainers Home
  • Documentors
    • Quick Start: First Documentation PR
    • Quick Start: Add New Documentation Through GitHub
    • Quick Start: Update Existing Docs Through GitHub
    • About Open edX® Documentation Standards
    • Documentor Guidelines
    • Documentation Maintenance Process
    • Open edX Documentation Writing Style Guide
    • Documentation Templates
      • Concept Document Template
      • Reference Document Template
      • How-To Document Template
      • Quickstart Document Template
    • Quick Reference: Writing RST
    • Documentation Audiences
    • Report a problem with the docs
    • Update An Existing Doc via GitHub
    • Make Changes to your Pull Request
    • Guidelines for Writing Global English
    • Open edX Documentation Writing Style Guide
    • Documentation Templates
      • Concept Document Template
      • Reference Document Template
      • How-To Document Template
      • Quickstart Document Template
    • Quick Reference: Writing RST
    • Add New Documentation via GitHub
    • Documentation Checklist
    • Make Changes to your Pull Request
    • Guidelines for Writing Global English
    • Open edX Documentation Writing Style Guide
    • Documentation Templates
      • Concept Document Template
      • Reference Document Template
      • How-To Document Template
      • Quickstart Document Template
    • Quick Reference: Writing RST
  • Translators
    • Get Started as a Translator
      • Quick Start: How to start translating for Open edX
    • How to fix translation validation errors
    • How to join a review team
    • How to join a translation team
    • How to request a new language for translation
    • Working With HTML
    • Working With Placeholders
    • Translators: Reference

Quick Starts

  • Educators: Build a Course
  • Site Operators: Set up Open edX
  • Developers: Contribute to Open edX
    • Quick Start: First Open edX Pull Request
  • Documentors: First Documentation PR

Open Source Community

  • Current Release: Sumac
    • Sumac Release Notes
      • Content Libraries Redesign - Beta
      • Customizing Site Header Using Frontend “Slots”
      • Customizing Learner Dashboard Using Frontend “Slots”
      • Aspects Course Comparison Dashboard
      • Sidebar Navigation Release Notes (Sumac)
      • Sumac Release is LTI Advantage Complete Certified
      • Simple example: Removing help button
    • Sumac Developer & Operator Release Notes
  • All Release Notes
    • Sumac: The Current Release
      • Sumac Release Notes
        • Content Libraries Redesign - Beta
        • Customizing Site Header Using Frontend “Slots”
        • Customizing Learner Dashboard Using Frontend “Slots”
        • Aspects Course Comparison Dashboard
        • Sidebar Navigation Release Notes (Sumac)
        • Sumac Release is LTI Advantage Complete Certified
        • Simple example: Removing help button
      • Sumac Developer & Operator Release Notes
    • Teak: June 2025 Release
      • Teak Release Notes
        • Stay Up To Date with Teak
        • Content Libraries - Unit Support
        • Design Tokens (New Theming System)
        • Aspects Updates
      • Teak Developer & Operator Release Notes
    • Ulmo: December 2025 Release
      • Ulmo Release Notes
        • Design Tokens (New Theming System)
      • Ulmo Developer & Operator Release Notes
    • Unsupported Open edX Releases
      • Open edX Redwood Release
        • Redwood Release Notes
        • Redwood Developer & Operator Release Notes
      • Open edX Quince Release
        • Open edX Quince Release - Feature-Based Notes
        • Open edX Quince Release - Developer & Operator Notes
      • Open edX Palm Release
        • Open edX Palm Release - Feature-Based Notes
        • Open edX Palm Release - Developer & Operator Notes
      • Open edX Olive Release
        • Open edX Olive Release - Feature-Based Notes
        • Open edX Olive Release
      • Open edX Nutmeg Release
      • Open edX Maple Release
      • Open edX Lilac Release
      • Open edX Koa Release
      • Open edX Juniper Release
        • Juniper release notes: Learner Experiences
        • Juniper release notes: Educator Experiences
        • Juniper release notes: Developer Experiences
      • Open edX Ironwood Release
      • Open edX Hawthorn Release
      • Open edX Ginkgo Release
      • Open edX Ficus Release
      • Open edX Eucalyptus Release
        • Enabling the Bulk Email Feature
        • Replacing the courseware_studentmodulehistory Table
      • Open edX Dogwood Release
      • Open edX Cypress Release
      • Open edX Birch Release
    • Site Operators: Named Release Branches and Tags
  • How to Contribute
  • OEPs (Open edX Proposals): Community Decision Documents
  • Open edX Site Operators
    • Installing, Configuring, and Running the Open edX Platform
      • General Information
        • Read Me
        • Getting Help
        • Open edX Browser Support
      • Open edX Platform Releases
        • Open edX Latest Platform Release
        • Open edX Olive Release
        • Open edX Nutmeg Release
        • Open edX Maple Release
        • Open edX Lilac Release
        • Open edX Koa Release
        • Open edX Juniper Release
        • Open edX Ironwood Release
        • Open edX Hawthorn Release
        • Open edX Ginkgo Release
        • Open edX Ficus Release
        • Open edX Eucalyptus Release
        • Open edX Dogwood Release
        • Open edX Cypress Release
        • Open edX Birch Release
      • Installing and Starting the Open edX Platform
        • Open edX Tutor Installation
      • Configuring the Open edX Platform
        • Guidelines for Updating the Open edX Platform
        • Configuring Open edX Sites
        • Changing the Appearance of Open edX Sites
        • Adding Custom Fields to the Registration Page
        • Specifying Allowed Registration Email Patterns
        • Adding the CourseTalk Widget
        • Enabling Open edX Search
        • Enabling Course Certificates
        • Enabling Self-Paced Courses
        • Enabling Public Course Content
        • Enabling Custom Courses
        • Enabling Custom Course Settings
        • Enabling Discussion Notifications
        • Enabling Entrance Exams
        • Configuring Open Response Assessments
        • Enabling Course Prerequisites
        • Enabling Course and Video Licensing
        • Configuring Transcript Behavior
        • Configuring an edX Instance as an LTI Tool Provider
        • Enabling Social Sharing of Courses and Certificates
        • Configuring a Password Policy
        • Enabling Third Party Authentication
        • Enabling Timed Exams
        • Setting Up the YouTube API Key
        • Installing an XBlock
        • Enabling a CDN for Course Assets
        • Enabling the Weekly Learning Goals Feature
        • Retrieving Extended Profile Metadata
      • Open edX Analytics Options
      • Adding ECommerce to Open edX
      • Setting Up the Open edX Mobile Applications
      • Index of Open edX Feature Flags
      • Glossary
      • Adding E-Commerce (Deprecated) to the Open edX Platform
        • Install and Start the E-Commerce Service
        • Comprehensive Theming
        • Manage Static Assets
        • Create E-Commerce Products
        • Enable the E-Commerce Service Receipt Page
        • Manage Orders
        • Test Your E-Commerce Application
        • Additional E-Commerce Features
        • Internationalization
      • Adding edX Insights (Deprecated)
        • Options for Installing edX Insights (Deprecated)
        • Using Elastic MapReduce on AWS
      • Deprecated Open edX Mobile Applications
    • Site Operators: Quick Start
    • Site Operators: How-tos
      • How to Enable a Waffle Flag for a User
      • Configuring Site-Wide Analytics Tools
      • Enabling Public Course Content
      • Configuring Google Analytics
      • Use A Frontend Plugin Framework Slot
    • Site Operators: Concepts
    • Site Operators: References
      • Available Frontend Plugin Slots
  • Site Operators: Quick Start
  • Site Operators: Concepts
  • Site Operators: References
    • Available Frontend Plugin Slots
  • Site Operators: How-tos
    • How to Enable a Waffle Flag for a User
    • Configuring Site-Wide Analytics Tools
    • Enabling Public Course Content
    • Configuring Google Analytics
    • Use A Frontend Plugin Framework Slot
  • Open edX Developers
    • Maintainers Home
  • Developer Quickstarts
    • Quick Start: First Open edX Pull Request
  • Concepts Home
    • Open edX Accessibility Concepts for Developers
    • Backend Layout and Approach
    • Hooks Extension Framework
    • OEP-58 Overview
    • Platform Overview
  • References Home
    • Running Pull Request Tests
    • Tools for Maintainers
    • Open edX Accessibility Reference for Developers
    • Event Reference
      • Events in the Tracking Logs
        • Reviewing a Sample Event
        • Common Fields
        • Student Events
        • Course Team Events
      • xAPI Events
      • Caliper Events
      • Alphabetical Tracking Log Event List
      • Data References
        • Open Response Assessment Data
        • User Info and Learner Progress Data
        • Wiki Data
    • Developer’s Guide for Open edX
      • Open edX Platform Architecture
      • Contributing to the Open edX Project
        • Process for Contributing Code
        • Contributing
        • Landing Your Work
        • Code Considerations
        • Overview of Review Process for Community Contributions
        • Pull Request Status Guide
        • Core Contributors to the Open edX Project
      • Extending the edX Platform
        • Options for Extending the Open edX Platform
        • Integrating XBlocks with edx-platform
      • Testing
        • Open edX Browser Support
        • GitHub Actions
        • Code Coverage
        • Code Quality
      • Analytics
      • Writing Good Code
        • Django Good Practices
        • Frontend Good Practices
      • Writing Code for Internationalization
        • Internationalization Coding Guidelines
      • Preventing Cross Site Scripting Vulnerabilities
        • Preventing Cross Site Scripting Vulnerabilities
        • Preventing XSS by Stripping HTML Tags
        • Preventing XSS in Django Templates
        • Preventing XSS in React
      • Language Style Guidelines
        • Open edX JavaScript Style Guide
        • Open edX Python Style Guide
        • Open edX Sass Style Guide
    • Glossary
    • Aspects: Learner analytics for the Open edX Platform
  • “How-To” Guides
    • How To Add a Catalog File
    • How To Add Sphinx Docs to a Repo
    • How To Enable Javascript Upgrade Automation
    • How To Enable Python Upgrade Automation
    • Enabling Translations on a New Repo
    • How To Get Ready for Frontend Development
    • How To Get Ready for Python Development
    • How-to get your repository docs on docs.openedx.org
    • How To Maintain a Repository
    • Maintaining Translations on Your Repo
    • Ongoing Maintainer’s Tasks
    • How to Switch to the sphinx-book-theme for Documentation
    • How to Set Up Github Action to Monitor Python Coverage
  • Translators Home
    • Get Started as a Translator
      • Quick Start: How to start translating for Open edX
    • How to fix translation validation errors
    • How to join a review team
    • How to join a translation team
    • How to request a new language for translation
    • Working With HTML
    • Working With Placeholders
    • Translators: Reference
  • Translators: Quickstarts
    • Quick Start: How to start translating for Open edX
  • Translators: Concepts
    • Translations Process
    • Working With HTML
    • Working With Placeholders
  • Translators: Reference
  • Translators: How-Tos
    • How to fix translation validation errors
    • How to join a review team
    • How to join a translation team
    • How to request a new language for translation

Other Topics

  • Documentation Feedback Form
  • Getting Help
  • Technical Decisions About This Site
    • 1. Purpose of this Repo
    • 2. Choosing RST
    • 3. Documentation Layout
    • 4. Don't Use AutoSectionLabel Extension
    • 5. Use Markdown READMEs for repos published to npm
    • 6. Remove Course Operators persona
  • Aspects: Learner analytics for the Open edX Platform


Open edX Wiki
Open edX website
Cookie Policy
Security Policy
  • Repository
  • Suggest edit
  • Open issue
  • .rst

Sidebar Navigation Release Notes (Sumac)

Contents

  • Overview
  • Collapsing and expanding the sidebar navigation
  • Viewing completed and in-progress items

Sidebar Navigation Release Notes (Sumac)#

The Product, Design, and Engineering Teams at Western Governor’s University, Raccoon Gang, and Axim Collaborative are thrilled to offer a new method for navigating course content on the Open edX platform! With the Sumac Release, the sidebar navigation will be offered as the default course navigation experience, giving learners and course delivery teams a new method for making their way through course content. Site operators should see Open edX Sumac Developer & Operator Release Notes for more detail.

Overview#

The new navigation experience allows learners to navigate through course material linearly or non-linearly via a new UI element on the side of the page that displays the user’s current course section, subsection, and unit.

../../../_images/LSN_Screenshot1.png

With sidebar navigation enabled, learners will still be able to navigate the course linearly by using the Next or Previous buttons above and below course content.

../../../_images/LSN_Screenshot2.png

Additionally, learners can easily navigate the course non-linearly without having to go to the Course Outline page. Learners can click on any unit in the sidebar to view that unit. The sidebar displays both the unit name and an icon indicating the type of content in that unit. The idea is to give the learner a fuller sense of what content exists where in the course, so that they can navigate it in a way that makes sense for them.

../../../_images/LSN_Screenshot3.png

Learners can explore the contents of a subsection by clicking on any collapsed subsection heading to expand and view the units within.

../../../_images/LSN_Screenshot4.png

The subsection heading expands when it is clicked to display its units.

../../../_images/LSN_Screenshot5.png

If a learner wants to view a unit in another section of the course, they can click on the back button in the upper corner of the sidebar to view all sections in a course.

../../../_images/LSN_Screenshot6.png

After, they will see all sections.

../../../_images/LSN_Screenshot7.png

The learner can then click on any other section to view its contents.

../../../_images/LSN_Screenshot8.png

Although the learner is not currently viewing a unit in this module, they are still able to view its contents.

../../../_images/LSN_Screenshot9.png

See View Course Sections from the Navigation Sidebar for details.

Collapsing and expanding the sidebar navigation#

The learner can easily collapse the sidebar navigation at any time to view the course content in a full page format by clicking the collapse button in the upper corner of the sidebar.

../../../_images/LSN_Screenshot10.png

The learner can revisit the sidebar navigation at any time by clicking the expand button in the upper corner of the page.

../../../_images/LSN_Screenshot11.png

As the learner advances through the course, the expanded or collapsed state of the sidebar remains the same until the learner changes it. See View Course Sections from the Navigation Sidebar for details.

Viewing completed and in-progress items#

When a learner completes a course unit, the icon next to the unit name in the sidebar navigation updates to indicate that it was completed.

../../../_images/LSN_Screenshot12.png

The icon next to the subsection name updates to a checkmark icon when a learner has completed all units in a subsection.

../../../_images/LSN_Screenshot13.png

Similar to a completed the subsection, the icon next to the section name updates to a checkmark icon once the learner has completed all subsections in the section.

../../../_images/LSN_Screenshot14.png

In addition to completions, in-progress work is indicated on the sidebar navigation for course sections and subsections. Once a unit is completed in a section or subsection, the icon next to the section or subsection name is updated to reflect the rough amount completed.

../../../_images/LSN_Screenshot15.png

These in-progress icons serve to convey to the learner what sections or subsections they have in-progress as well as how much content they’ve completed for each section or subsection at a glance.

Maintenance chart

Review Date

Working Group Reviewer

Release

Test situation

2024-06-01

Docs WG

Redwood

Pass

Note

Known issues with sidebar navigation include:

  • When a member of the course delivery team updates the name of a course unit, the unit name updates at the top of the unit page, but does not update in the sidebar navigation.

  • When using content groups in a course, the sidebar navigation does not hide hidden units when a staff user views the course as a content group using the masquerading feature. Content groups work as expected for real learners in content groups. Staff can masquerade as an individual user in a specific content group to view how a member of the content group actually sees the course and the sidebar.

  • Course sections, subsections, and unit names may appear as missing from the sidebar navigation in sections that include content that has yet to be published.

Maintenance chart

Review Date

Working Group Reviewer

Release

Test situation

2025-04-15

sarina

Sumac

Pass


Feedback

previous

Aspects Course Comparison Dashboard

next

Sumac Release is LTI Advantage Complete Certified

Contents
  • Overview
  • Collapsing and expanding the sidebar navigation
  • Viewing completed and in-progress items

By Open edX Documentation Working Group

© Copyright 2025, Axim Collaborative.