Building and Running an Open edX Course: Olive Release
  • 1. General Information
    • 1.1. Read Me
    • 1.2. Other edX Resources
      • 1.2.1. Resources for edx.org Learners
      • 1.2.2. The edX Partner Portal
      • 1.2.3. The Open edX Portal
      • 1.2.4. System Status
      • 1.2.5. Resources for edx.org Course Teams
      • 1.2.6. Resources for Researchers
      • 1.2.7. Resources for Developers
      • 1.2.8. Resources for Open edX
    • 1.3. edX Browser Support
  • 2. Getting Started
    • 2.1. Getting Started with Studio
      • 2.1.1. What Is Studio?
      • 2.1.2. What Is the LMS?
  • 3. Exploring Your Dashboard and Profile
    • 3.1. Accessing Your Courses from the Dashboard
      • 3.1.1. Sharing Your Courses on Social Media
    • 3.2. Adding Profile Information
      • 3.2.1. Add or Update a Limited Profile
      • 3.2.2. Add or Update a Full Profile
      • 3.2.3. Add Links to Your Personal Social Media Accounts
      • 3.2.4. View Another Learner’s Profile
    • 3.3. Updating Course-Specific Settings
      • 3.3.1. Change a Course Email Preference
  • 4. Reaching As Many Learners As Possible
    • 4.1. Designing Your Course For a Mobile Experience
      • 4.1.1. Testing Your Course For Mobile Devices
  • 5. Accessibility Best Practices Guidance for Content Providers
    • 5.1. What Is The edX Accessibility Best Practices Guidance Based On?
    • 5.2. Supporting Learners with Diverse Needs
      • 5.2.1. Who Are Our Learners?
      • 5.2.2. Removing Barriers to Learning
    • 5.3. Accessibility Best Practices for Developing Course Content
      • 5.3.1. Make Sure Your Course Content is Perceivable
      • 5.3.2. Make Sure Your Course Content is Understandable
      • 5.3.3. Use Best Practices for Describing Images
      • 5.3.4. Create Accessible Course Materials
      • 5.3.5. Use Best Practices for Mathematical Content
      • 5.3.6. Use Best Practices for Custom Content Types
      • 5.3.7. Create Accessible Media
      • 5.3.8. Use Best Practices for HTML Markup
      • 5.3.9. Apply Universal Design for Learning
  • 6. Setting Up a Course
    • 6.1. Planning Course Information
      • 6.1.1. Course Title and Number
      • 6.1.2. Images and Videos for a Course or Program
      • 6.1.3. Course Description
      • 6.1.4. Additional Course Information
    • 6.2. Planning Course Run Information
      • 6.2.1. Planning Course Staff
      • 6.2.2. Scheduling a Course Run
      • 6.2.3. Additional Course Run Information
    • 6.3. Creating a Course
      • 6.3.1. Adding Course Team Members in Studio
      • 6.3.2. Creating a New Course in Studio
      • 6.3.3. Set the Course Run Schedule and Pacing in Studio
      • 6.3.4. Specifying Prerequisite Courses and Exams
      • 6.3.5. Creating a Course About Page in Studio
      • 6.3.6. Setting Up Certificates in Studio
      • 6.3.7. Course Search
      • 6.3.8. Creating a Custom Course
  • 7. Developing Your Course
    • 7.1. Getting Started with Course Content Development
      • 7.1.1. Understanding Course Building Blocks
      • 7.1.2. Creating New Course Content
      • 7.1.3. Making Course Content Visible to Students
      • 7.1.4. Making Course Content Searchable
      • 7.1.5. Revising Content
    • 7.2. Developing Your Course Outline
      • 7.2.1. Open the Course Outline
      • 7.2.2. Understanding a Course Outline
      • 7.2.3. Navigate the Course Outline
      • 7.2.4. Add Content in the Course Outline
      • 7.2.5. Modify Settings for Objects in the Course Outline
      • 7.2.6. Publish Content from the Course Outline
      • 7.2.7. Reorganize the Course Outline
      • 7.2.8. Delete Content in the Course Outline
    • 7.3. Developing Course Sections
      • 7.3.1. What Is a Section?
      • 7.3.2. Viewing Sections in the Outline
      • 7.3.3. Sections and Visibility to Learners
      • 7.3.4. Release Statuses of Sections
      • 7.3.5. Create a Section
      • 7.3.6. Change a Section Name
      • 7.3.7. Set a Section Release Date
      • 7.3.8. Set Section Highlights for Highlight Emails
      • 7.3.9. Publish All Units in a Section
      • 7.3.10. Hide a Section from Learners
      • 7.3.11. Delete a Section
    • 7.4. Developing Course Subsections
      • 7.4.1. What Is a Subsection?
      • 7.4.2. Viewing Subsections in the Outline
      • 7.4.3. Subsections and Visibility to Learners
      • 7.4.4. Release Statuses of Subsections
      • 7.4.5. Create a Subsection
      • 7.4.6. Change a Subsection Name
      • 7.4.7. Set a Subsection Release Date
      • 7.4.8. Set the Assignment Type and Due Date for a Subsection
      • 7.4.9. Set Problem Results Visibility
      • 7.4.10. Publish All Units in a Subsection
      • 7.4.11. Hiding a Subsection from Learners
      • 7.4.12. Delete a Subsection
    • 7.5. Developing Course Units
      • 7.5.1. What Is a Unit?
      • 7.5.2. Viewing Units in the Outline
      • 7.5.3. Viewing the Unit Page
      • 7.5.4. Viewing Units as a Learner
      • 7.5.5. The Unit Workflow
      • 7.5.6. Unit Publishing Status and Visibility to Learners
      • 7.5.7. Unit Publishing Statuses
      • 7.5.8. Create a Unit
      • 7.5.9. Edit a Unit
      • 7.5.10. Set Access Restrictions For a Unit
      • 7.5.11. Preview a Unit
      • 7.5.12. Publish a Unit
      • 7.5.13. Discard Changes to a Unit
      • 7.5.14. View a Published Unit
      • 7.5.15. Hide a Unit from Learners
      • 7.5.16. Delete a Unit
    • 7.6. Developing Course Components
      • 7.6.1. What is a Component?
      • 7.6.2. Add a Component
      • 7.6.3. Edit a Component
      • 7.6.4. Set Access Restrictions for a Component
      • 7.6.5. Duplicate a Component
      • 7.6.6. Delete a Component
      • 7.6.7. Reorganizing Components
      • 7.6.8. Components that Contain Other Components
    • 7.7. Controlling Content Visibility and Access
      • 7.7.1. Release Dates
      • 7.7.2. Unit Publishing Status
      • 7.7.3. Visibility Settings
      • 7.7.4. Access Settings
      • 7.7.5. Prerequisite Course Subsections
    • 7.8. Course Licensing
      • 7.8.1. License Options
      • 7.8.2. Set Course Content Licensing in Studio
      • 7.8.3. Set Video Licensing
      • 7.8.4. Learners’ View of Licenses
    • 7.9. Testing Your Course Content
      • 7.9.1. Viewing Published and Released Content
      • 7.9.2. Previewing Draft Content
      • 7.9.3. Viewing Course Content Based on Roles
  • 8. Adding Course Components
    • 8.1. Working with Text Components
      • 8.1.1. Text Component Overview
      • 8.1.2. Options for Editing Text Components
      • 8.1.3. Create a Text Component
      • 8.1.4. Add a Link in a Text Component
      • 8.1.5. Add an Image to a Text Component
    • 8.2. Working with Video Components
    • 8.3. Working with Discussion Components
      • 8.3.1. Overview
      • 8.3.2. Create a Discussion Component
      • 8.3.3. A Learner’s View of the Discussion
    • 8.4. Working with Problem Components
      • 8.4.1. Adding a Problem
      • 8.4.2. The Learner View of a Problem
      • 8.4.3. Editing a Problem in Studio
      • 8.4.4. Defining Settings for Problem Components
      • 8.4.5. Including Multiple Questions in One Component
      • 8.4.6. Adding Feedback and Hints to a Problem
      • 8.4.7. Awarding Partial Credit for a Problem
      • 8.4.8. Problem Randomization
      • 8.4.9. Modifying a Released Problem
    • 8.5. Working with Content Libraries
      • 8.5.1. Content Libraries Overview
      • 8.5.2. Create a New Library
      • 8.5.3. Edit a Library
      • 8.5.4. Add Components to a Library
      • 8.5.5. View the Contents of a Library
      • 8.5.6. Edit Components in a Library
      • 8.5.7. Delete a Library
      • 8.5.8. Give Other Users Access to Your Library
      • 8.5.9. Exporting and Importing a Library
  • 9. Creating and Adding Video Content
    • 9.1. Video Process Overview
    • 9.2. Preparing a Video
      • 9.2.1. Set Up a Hosting Service
      • 9.2.2. Create a Video
      • 9.2.3. Obtain a Video Transcript
    • 9.3. Upload a Video
    • 9.4. Adding a Video to a Course
      • 9.4.1. Add a Video and Transcript
    • 9.5. Specifying Additional Video Options
      • 9.5.1. Enable Video and Transcript Downloads
      • 9.5.2. Set Advanced Options
    • 9.6. Specifying Additional Transcript Options
      • 9.6.1. Edit a Video Transcript
      • 9.6.2. Add a Supplemental Downloadable Transcript
      • 9.6.3. Add a Transcript in Another Language
    • 9.7. Troubleshooting Video Problems
  • 10. Adding Exercises and Tools
    • 10.1. Problems, Exercises, and Tools
      • 10.1.1. Levels of Support
      • 10.1.2. Enhancing Your Course with Additional Exercises and Tools
      • 10.1.3. Core Problem Types
      • 10.1.4. Additional Exercises and Tools
      • 10.1.5. Mobile-Ready Problem Types
      • 10.1.6. Adding Unsupported Problem Types and Exercises
    • 10.2. Enabling Additional Exercises and Tools
      • 10.2.1. Enable an Exercise or Tool for Your Course
    • 10.3. Annotation Problem
      • 10.3.1. Enable Annotation Problems
      • 10.3.2. Create an Annotation Problem
    • 10.4. Calculator Tool
      • 10.4.1. Overview
      • 10.4.2. Enable the Calculator Tool
    • 10.5. Checkbox Problem
      • 10.5.1. Overview
      • 10.5.2. Adding a Checkbox Problem
      • 10.5.3. Adding Feedback to a Checkbox Problem
      • 10.5.4. Adding Hints to a Checkbox Problem
      • 10.5.5. Awarding Partial Credit in a Checkbox Problem
      • 10.5.6. Checkbox Problem OLX Reference
      • 10.5.7. Advanced Options for Checkbox Problems
    • 10.6. Chemical Equation Problem
      • 10.6.1. Create a Chemical Equation Problem
      • 10.6.2. Chemical Equation Problem XML
    • 10.7. Circuit Schematic Builder Problem
      • 10.7.1. Create a Circuit Schematic Builder Problem
    • 10.8. Completion Tool
      • 10.8.1. Overview
      • 10.8.2. Enable the Completion Tool
      • 10.8.3. Add a Completion Component
    • 10.9. Conditional Module
      • 10.9.1. Format description
      • 10.9.2. Examples
    • 10.10. Custom JavaScript Display and Grading Problem
      • 10.10.1. Create a Custom JavaScript Display and Grading Problem
      • 10.10.2. JavaScript Input Problem XML
    • 10.11. Drag and Drop Problem
      • 10.11.1. Overview of Drag and Drop Problems
      • 10.11.2. Creating a Drag and Drop Problem
      • 10.11.3. Understanding the Drag and Drop Editing Controls
      • 10.11.4. Changing the Visual Style of a Drag and Drop Problem
    • 10.12. Drag and Drop Problem (Deprecated)
      • 10.12.1. Adding a Drag and Drop Problem
      • 10.12.2. Drag and Drop Problem XML
      • 10.12.3. Targets on Draggables
      • 10.12.4. Correct answer format
      • 10.12.5. Grading logic
    • 10.13. Dropdown Problem
      • 10.13.1. Overview
      • 10.13.2. Adding a Dropdown Problem
      • 10.13.3. Adding Feedback to a Dropdown Problem
      • 10.13.4. Adding Hints to a Dropdown Problem
      • 10.13.5. Dropdown Problem OLX Reference
    • 10.14. External Grader
      • 10.14.1. External Grader Workflow
      • 10.14.2. External Grader Example
      • 10.14.3. External Grader Problem Requirements
      • 10.14.4. Create an External Grader Problem in Studio
    • 10.15. Full Screen Image Tool
      • 10.15.1. The Learner View of a Full Screen Image
      • 10.15.2. Create a Full Screen Image
    • 10.16. Gene Explorer Tool
      • 10.16.1. Gene Explorer Code
    • 10.17. Google Calendar Tool
      • 10.17.1. Overview
      • 10.17.2. Embedding a Google Calendar in Your Course
      • 10.17.3. Editing Google Calendars
    • 10.18. Google Drive Files Tool
      • 10.18.1. Overview
      • 10.18.2. Embedding a Google Drive File in Your Course
      • 10.18.3. Editing Google Drive Files
    • 10.19. Iframe Tool
      • 10.19.1. Create an IFrame Tool
    • 10.20. Image Mapped Input Problem
      • 10.20.1. Create an Image Mapped Input Problem
      • 10.20.2. Image Mapped Input Problem XML
    • 10.21. LTI Component
      • 10.21.1. Overview
      • 10.21.2. Enabling LTI Components for a Course
      • 10.21.3. Setting up an LTI 1.1 component
      • 10.21.4. Setting up an LTI 1.3 component
      • 10.21.5. Enabling and using LTI Advantage features
      • 10.21.6. LTI Component Settings
    • 10.22. Math Expression Input Problems
      • 10.22.1. Overview
      • 10.22.2. Adding a Math Expression Input Problem
      • 10.22.3. Math Expression Input Problem OLX Reference
    • 10.23. Molecule Editor Tool (Deprecated)
      • 10.23.1. Create the Molecule Editor
    • 10.24. Molecule Viewer Tool
      • 10.24.1. Create the Molecule Viewer Tool
    • 10.25. Multiple Choice Problem
      • 10.25.1. Overview
      • 10.25.2. Adding a Multiple Choice Problem
      • 10.25.3. Adding Feedback to a Multiple Choice Problem
      • 10.25.4. Adding Hints to a Multiple Choice Problem
      • 10.25.5. Awarding Partial Credit in a Multiple Choice Problem
      • 10.25.6. Multiple Choice Problem OLX Reference
      • 10.25.7. Advanced Options for Multiple Choice Problems
    • 10.26. Multiple Choice and Numerical Input Problem
      • 10.26.1. Create a Multiple Choice and Numerical Input Problem
      • 10.26.2. Multiple Choice and Numerical Input Problem Code
    • 10.27. Notes Tool
    • 10.28. Numerical Input Problem
      • 10.28.1. Overview
      • 10.28.2. Adding a Numerical Input Problem
      • 10.28.3. Adding a Tolerance, Multiple Correct Responses, or a Range
      • 10.28.4. Adding Feedback to a Numerical Input Problem
      • 10.28.5. Adding Hints to a Numerical Input Problem
      • 10.28.6. Awarding Partial Credit in a Numerical Input Problem
      • 10.28.7. Add Text after the Numeric Response Field
      • 10.28.8. Numerical Input Problem OLX Reference
    • 10.29. Open Response Assessments
      • 10.29.1. Introduction to Open Response Assessments
      • 10.29.2. Create an Open Response Assessment Assignment
      • 10.29.3. Managing Open Response Assessment Assignments
      • 10.29.4. Staff Grading for Open Response Assignments
      • 10.29.5. Accessing Metrics for ORA Assignments
    • 10.30. Oppia Exploration Tool
      • 10.30.1. Overview
      • 10.30.2. Enable the Oppia Exploration Tool
      • 10.30.3. Add an Oppia Exploration in Studio
    • 10.31. Peer Instruction Tool
      • 10.31.1. Assignment Overview
      • 10.31.2. Adding a Peer Instruction Assignment in Studio
      • 10.31.3. Reviewing a Histogram of Learner Responses
    • 10.32. Periodic Table Tool
      • 10.32.1. Create the Periodic Table Tool
    • 10.33. Poll Tool
      • 10.33.1. Overview
      • 10.33.2. Enable the Poll Tool
      • 10.33.3. Add a Poll in edX Studio
      • 10.33.4. Add a Poll in OLX
      • 10.33.5. Editing Published Polls
      • 10.33.6. View Poll Results
    • 10.34. Poll Tool for OLX
      • 10.34.1. Terminology
      • 10.34.2. Create a Poll
      • 10.34.3. Format description
      • 10.34.4. Example
    • 10.35. Problem with Adaptive Hint
      • 10.35.1. Create a Problem with an Adaptive Hint
      • 10.35.2. Problem with Adaptive Hint XML
    • 10.36. Problem Written in LaTeX
      • 10.36.1. Create a Problem Written in LaTeX
    • 10.37. Protex Protein Builder Tool
      • 10.37.1. Create the Protein Builder Tool
      • 10.37.2. Protein Builder Tool Code
    • 10.38. Qualtrics Survey Tool
      • 10.38.1. Add a Qualtrics Survey to Your Course
      • 10.38.2. View Survey Responses
    • 10.39. Randomized Content Blocks
      • 10.39.1. Use Components from Libraries in a Course
      • 10.39.2. Enable Content Libraries
      • 10.39.3. View the Matching Components in a Randomized Content Block
      • 10.39.4. Editing Components in Randomized Content Blocks
      • 10.39.5. Getting the Latest Version of Library Content
      • 10.39.6. Preview the Randomized Content in Student View
      • 10.39.7. View a Specific Student’s Assigned Problems from a Randomized Content Block
      • 10.39.8. Adjust Grades for a Problem from a Randomized Content Block
    • 10.40. Recommender Tool
      • 10.40.1. Overview
      • 10.40.2. Enable the Recommender Tool
      • 10.40.3. Add a Recommender
    • 10.41. Staff Graded Points
      • 10.41.1. Create a Staff Graded Points assignment
    • 10.42. Survey Tool
      • 10.42.1. Overview
      • 10.42.2. Enable the Survey Tool
      • 10.42.3. Add a Survey in edX Studio
      • 10.42.4. Add a Survey in OLX
      • 10.42.5. Editing Published Surveys
      • 10.42.6. View Survey Results
    • 10.43. Text Input Problem
      • 10.43.1. Overview
      • 10.43.2. Adding a Text Input Problem
      • 10.43.3. Adding Multiple Correct Responses
      • 10.43.4. Adding Feedback to a Text Input Problem
      • 10.43.5. Adding Hints to a Text Input Problem
      • 10.43.6. Adding Text after the Response Field
      • 10.43.7. Case Sensitivity and Text Input Problems
      • 10.43.8. Response Field Length in Text Input Problems
      • 10.43.9. Allowing Regular Expressions as Answers for Text Input Problems
      • 10.43.10. Text Input Problem XML Reference
      • 10.43.11. Deprecated Hinting Method
    • 10.44. Word Cloud Tool
      • 10.44.1. Enable the Word Cloud Tool
      • 10.44.2. Create a Word Cloud
    • 10.45. Write-Your-Own-Grader Problem
      • 10.45.1. Overview
      • 10.45.2. Create a Custom Python-Evaluated Input Problem in Studio
      • 10.45.3. Script Tag Format
    • 10.46. Zooming Image Tool
      • 10.46.1. Components of a Zooming Image Tool
      • 10.46.2. Create a Zooming Image Tool
    • 10.47. Using MathJax for Mathematics
      • 10.47.1. Adding MathJax to Text Components
      • 10.47.2. Adding MathJax to Problem Components
  • 11. Adding Course Assets
    • 11.1. Adding Files to a Course
      • 11.1.1. The Files & Uploads Page
      • 11.1.2. File Size
      • 11.1.3. Upload Files
      • 11.1.4. Find an Uploaded File
      • 11.1.5. Sort Files
      • 11.1.6. Filter Files
      • 11.1.7. Use an Uploaded File Inside or Outside the Course
      • 11.1.8. Lock a File
      • 11.1.9. Delete a File
    • 11.2. Adding Course Updates and Handouts
      • 11.2.1. Add a Course Update
      • 11.2.2. Add a Course Handout
    • 11.3. Managing the Pages in Your Course
      • 11.3.1. Working with the Default Pages
      • 11.3.2. Enabling Additional Applications & Resources
      • 11.3.3. Configuring Applications & Resources
      • 11.3.4. Reordering and Deleting Custom Pages
    • 11.4. Textbooks
      • 11.4.1. Add a Textbook
      • 11.4.2. Delete a Textbook
      • 11.4.3. Delete a Chapter
    • 11.5. Using the Course Wiki
      • 11.5.1. About the Course Wiki
      • 11.5.2. Managing the Course Wiki
      • 11.5.3. Showing or Hiding the Wiki
      • 11.5.4. Controlling Access to the Wiki
      • 11.5.5. Setting Permissions for Wiki Articles
      • 11.5.6. Seeding the Wiki
      • 11.5.7. Adding a Wiki Article
      • 11.5.8. Editing a Wiki Article
      • 11.5.9. Searching for Wiki Articles
      • 11.5.10. Managing Versions of Wiki Articles
      • 11.5.11. Locking a Wiki Article
      • 11.5.12. Deleting a Wiki Article
  • 12. Using Enhanced Capabilities In Your Course
    • 12.1. Including Learner Cohorts
      • 12.1.1. Using Cohorts in Your Courses
      • 12.1.2. Enabling and Configuring the Cohorts Feature
      • 12.1.3. Creating Cohort-Specific Course Content
      • 12.1.4. Setting up Discussions in Courses with Cohorts
    • 12.2. Offering Different Content to Different Learner Groups
      • 12.2.1. Offering Different Content to Learners Based on Their Enrollment Track
      • 12.2.2. Offering Different Content to Learners Based on Cohort
    • 12.3. Including Teams
      • 12.3.1. Using Teams in Your Courses
      • 12.3.2. The Learner’s Experience of Teams
      • 12.3.3. Managing Team Discussions
    • 12.4. Creating Content Experiments
      • 12.4.1. Overview of Content Experiments
      • 12.4.2. Configure Your Course for Content Experiments
      • 12.4.3. Add Content Experiments to Your Course
      • 12.4.4. Test Content Experiments
    • 12.5. Offering Timed Exams
      • 12.5.1. Overview
      • 12.5.2. Enable Timed Exams
      • 12.5.3. Set a Subsection to be Timed
      • 12.5.4. Grant Learners More Time for a Timed or Proctored Exam
      • 12.5.5. Resuming an Exam in an Error State
      • 12.5.6. Allow Learners to Retake a Timed or Proctored Exam
      • 12.5.7. Hide a Timed Exam After Its Due Date
    • 12.6. Using Open edX as an LTI Tool Provider
      • 12.6.1. Reusing Course Content with LTI
      • 12.6.2. Preparing to Reuse Course Content
      • 12.6.3. Determining Content Addresses
      • 12.6.4. Grading Remote Content
      • 12.6.5. Example: edX as an LTI Provider to Canvas
      • 12.6.6. Example: edX as an LTI Provider to Blackboard
  • 13. Proctored Exams
    • 13.1. Proctored Exam Overview
    • 13.2. Preparing Learners for Proctored Exams
      • 13.2.1. The Learner Experience of Proctored Exams
      • 13.2.2. Practice Proctored Exams
    • 13.3. Creating Proctored Exams
      • 13.3.1. Enable Proctored Exams
      • 13.3.2. Create a Proctored Exam or Practice Proctored Exam
      • 13.3.3. Specify Exam Rules and Exceptions
      • 13.3.4. Allow Opting Out of Proctored Exams
      • 13.3.5. Check Proctoring Results
    • 13.4. Online Proctoring Rules for Learners
      • 13.4.1. Learner Rules for Online Proctored Exams
  • 14. Establishing a Grading Policy For Your Course
    • 14.1. Set the Grade Range
      • 14.1.1. Grade Ranges and Certificates
    • 14.2. Set the Grace Period
    • 14.3. Configure the Assignment Types
      • 14.3.1. Assignment Type Fields
    • 14.4. Graded Subsections
    • 14.5. The Learner View of Grades
  • 15. Releasing Your Course
    • 15.1. Beta Testing a Course
      • 15.1.1. Overview
      • 15.1.2. The Beta Testing Process
      • 15.1.3. The Beta Testing Role
      • 15.1.4. What to Test
      • 15.1.5. How Beta Testers See Course Content
      • 15.1.6. Adding Beta Testers
      • 15.1.7. Reporting Issues During a Course
    • 15.2. Course Launching Activities
      • 15.2.1. Course Launch Checklist in Studio
      • 15.2.2. Course Launch Checklist Timeline
    • 15.3. Exporting and Importing a Course
      • 15.3.1. Export a Course
      • 15.3.2. Course Outline Terminology in Exported Files
      • 15.3.3. Import a Course
      • 15.3.4. Work with the .tar.gz File
  • 16. Managing a Running Course
    • 16.1. Course Information
      • 16.1.1. View Basic Course Information
    • 16.2. Automatic Email Messages from the Open edX Platform
      • 16.2.1. Automatic Email Message Text
    • 16.3. Bulk Email Messages from the Course Team
      • 16.3.1. Message Addressing
      • 16.3.2. Composing Email Messages
      • 16.3.3. Send an Email Message to Course Participants
      • 16.3.4. Send a Scheduled Email Message to Course Participants
      • 16.3.5. Use Keywords in Messages
      • 16.3.6. Message Workflow States
      • 16.3.7. Review Sent Messages
      • 16.3.8. Email Task History Report
      • 16.3.9. Example Messages to Learners
    • 16.4. Enrollment
      • 16.4.1. Registration and Enrollment
      • 16.4.2. Options for Enrolling Learners in a Course
      • 16.4.3. Enroll Learners in a Course
      • 16.4.4. Report Learners Not Yet Enrolled
      • 16.4.5. Unenroll Learners from a Course
    • 16.5. Staff Debug Info
  • 17. Managing Discussions
    • 17.1. Creating Course Discussions
      • 17.1.1. Configuring Edx Discussions
      • 17.1.2. Create Course-Wide Discussion Topics
      • 17.1.3. Create Content-Specific Discussion Topics
      • 17.1.4. Understanding When Learners Can See Discussion Topics
      • 17.1.5. Allowing Learners to Make Anonymous Discussion Posts
      • 17.1.6. Discussions in the edX Mobile App
    • 17.2. Running Course Discussions
      • 17.2.1. Understanding the Elements of a Discussion
      • 17.2.2. Using Naming Conventions for Discussion Topics
      • 17.2.3. Seeding Discussion Topics
      • 17.2.4. Minimizing Thread Proliferation
      • 17.2.5. Closing Discussions
    • 17.3. About Divided Discussion Topics
      • 17.3.1. What Are Divided Discussions?
      • 17.3.2. Setting Up Divided Discussions
      • 17.3.3. Divide All Content-Specific Discussion Topics
      • 17.3.4. Divide Course-Wide Discussion Topics
    • 17.4. Managing Divided Discussion Topics
      • 17.4.1. Overview
      • 17.4.2. Identifying Who Can Read a Post
      • 17.4.3. Choosing the Visibility of a Post
      • 17.4.4. Viewing the Posts of a Group
    • 17.5. Moderating Discussions
      • 17.5.1. About Discussion Moderation Roles
      • 17.5.2. Assigning Discussion Moderation Roles
      • 17.5.3. Provide Guidelines for Learners
      • 17.5.4. Develop a Positive Discussion Culture
      • 17.5.5. Find Questions and Discussions
      • 17.5.6. Edit Messages
      • 17.5.7. Delete Messages
      • 17.5.8. Respond to Reports of Misuse
      • 17.5.9. View Profile Information for Discussion Participants
      • 17.5.10. Block Users
    • 17.6. Guidance for Discussion Moderators
      • 17.6.1. Responsibilities
      • 17.6.2. Qualities of Good Discussion Moderators
      • 17.6.3. Best Practices for Discussion Moderation
      • 17.6.4. Guidelines for Specific Types of Posts
  • 18. Managing Learner Progress and Grades
    • 18.1. Learner Data
      • 18.1.1. Guidance for Working with Personal Information
      • 18.1.2. Accessing Learner Data
      • 18.1.3. Accessing Anonymized Learner IDs
    • 18.2. Answer Data
      • 18.2.1. Learner Answer Submissions
      • 18.2.2. Student Answer Distribution
    • 18.3. Learner Grades and Grading
      • 18.3.1. Review How Grading Is Configured for Your Course
      • 18.3.2. Generate a Grade Report for All Learners in a Course
      • 18.3.3. Generate a Problem Grade Report for All Learners in a Course
      • 18.3.4. Review Learner Grades on the Instructor Dashboard
      • 18.3.5. Override Learner Subsection Scores in Bulk
      • 18.3.6. Per-Learner Interventions Report
      • 18.3.7. Check the Progress of a Specific Learner
      • 18.3.8. Grant Due Date Extensions for a Specific Learner
      • 18.3.9. Adjust Grades for One or All Learners
    • 18.4. Obtaining Certificate Data
      • 18.4.1. Access Certificate Data
      • 18.4.2. Columns in the Certificate Report
    • 18.5. Ending a Course
      • 18.5.1. Sending a Farewell Message
      • 18.5.2. Assigning Final Grades
      • 18.5.3. Issuing Certificates
  • 19. Re-running Your Course
    • 19.1. Re-running a Course
      • 19.1.1. Data Duplicated When You Re-Run a Course
      • 19.1.2. Re-Run a Course
      • 19.1.3. Update the New Course
  • 20. Glossary
    • 20.1. A
    • 20.2. C
    • 20.3. D
    • 20.4. E
    • 20.5. F
    • 20.6. G
    • 20.7. H
    • 20.8. I
    • 20.9. K
    • 20.10. L
    • 20.11. M
    • 20.12. N
    • 20.13. O
    • 20.14. P
    • 20.15. Q
    • 20.16. R
    • 20.17. S
    • 20.18. T
    • 20.19. U
    • 20.20. V
    • 20.21. W
    • 20.22. XYZ
 
Building and Running an Open edX Course: Olive Release
  • Table of Contents »
  • 10.13. Dropdown Problem
  • Get Help orGive Doc Feedback Edit on GitHub

10.13. Dropdown Problem¶

Note

EdX offers full support for this problem type.

The dropdown problem type is a core problem type that can be added to any course. Dropdown problems include a question or prompt and several answer options with a single correct answer. By adding hints, feedback, or both, you can give learners guidance and help when they work on a problem.

  • Overview

    • Example Dropdown Problem

    • Analyzing Performance on Dropdown Problems

  • Adding a Dropdown Problem

    • Use the Simple Editor to Add a Dropdown Problem

    • Use the Advanced Editor to Add a Dropdown Problem

  • Adding Feedback to a Dropdown Problem

    • Configuring Feedback in the Simple Editor

    • Configuring Feedback in the Advanced Editor

    • Customizing Feedback Labels

  • Adding Hints to a Dropdown Problem

    • Configure Hints in the Simple Editor

    • Configure Hints in the Advanced Editor

  • Dropdown Problem OLX Reference

    • Template

    • Elements

For more information about the core problem types, see Working with Problem Components.

10.13.1. Overview¶

In dropdown problems, learners select one option from a list of answer options. Unlike multiple choice problems, where the answer choices are always visible directly below the question, the answer options for dropdown problems do not appear until the learner selects the dropdown arrow.

Dropdown problems can only have one correct answer per question, we reccomend adding a “Both B & C” option where multiple multiple selections could be correct.

10.13.1.1. Example Dropdown Problem¶

In the LMS, learners select a single answer option to complete a dropdown problem. An example of a completed dropdown problem follows.

A problem component that contains a series of three dropdown problems. The questions have been answered, and two are marked incorrect and one correct.

In this example, a single problem component contains multiple questions, all of them using the dropdown problem type. To add the example illustrated above, you enter the following text and Markdown formatting in the simple editor in Studio. Then, select Settings for the problem to define settings. To specify that each question is worth one point, leave the Problem Weight field empty.

>>What type of data is age?<<
[[Nominal, Discrete, (Continuous)]]
---
>>What type of data is age, when rounded to the nearest year?<<
[[
Nominal
(Discrete)
Continuous
]]
---
>>What type of data is life stage, such as infant, child, or adult?<<
[[(Nominal), Discrete, Continuous]]

Note

You separate multiple questions in a problem component with three hyphen (---) characters. You can separate the answer options with either comma (,) characters or new lines. Each question can ONLY have a single correct answer.

The OLX markup for this example problem follows.

<problem>
  <optionresponse>
    <label>What type of data is age?</label>
    <optioninput options="('Nominal','Discrete','Continuous')"
     correct="Continuous"></optioninput>
  </optionresponse>
  <optionresponse>
    <label>What type of data is age, when rounded to the nearest year?</label>
    <optioninput options="('Nominal','Discrete','Continuous')"
     correct="Discrete"></optioninput>
    </optionresponse>
  <optionresponse>
    <label>What type of data is life stage, such as infant, child, or adult?</label>
    <optioninput options="('Nominal','Discrete','Continuous')"
     correct="Nominal"></optioninput>
  </optionresponse>
</problem>

10.13.1.2. Analyzing Performance on Dropdown Problems¶

For the dropdown problems in your course, you can use edX Insights to review aggregated learner performance data and examine submitted answers. For more information, see Using edX Insights.

10.13.2. Adding a Dropdown Problem¶

You add dropdown problems in Studio by selecting the Problem component type and then using either the simple editor or the advanced editor to specify the prompt and the answer options.

  • Use the Simple Editor to Add a Dropdown Problem

  • Use the Advanced Editor to Add a Dropdown Problem

Note

You can begin work on the problem in the simple editor, and then switch to the advanced editor. However, after you save any changes you make in the advanced editor, you cannot switch back to the simple editor.

10.13.2.1. Use the Simple Editor to Add a Dropdown Problem¶

When you add a dropdown problem, you can choose one of these templates.

  • Dropdown

  • Dropdown with Hints and Feedback

These templates include the Markdown formatting that you use in the simple editor to add a problem without, or with, hints and feedback.

To use the simple editor to add a problem, follow these steps.

  1. In the unit where you want to create the problem, under Add New Component select Problem.

  2. From the list of Common Problem Types, select the type of problem you want to add. Studio adds a template for the problem to the unit.

  3. Select Edit. The simple editor opens to a template that shows the Markdown formatting that you use for this problem type.

  4. Replace the guidance provided by the template to add your own text for the question or prompt, answer options, explanation, and so on.

    To format equations, you can use MathJax. For more information, see Using MathJax for Mathematics.

  5. Select Settings to provide an identifying Display Name and define settings for the problem. For more information, see Defining Settings for Problem Components.

  6. Select Save.

10.13.2.2. Use the Advanced Editor to Add a Dropdown Problem¶

You can use the advanced editor to identify the elements of a dropdown problem with OLX. For more information, see Dropdown Problem OLX Reference.

To use the advanced editor to add a problem, follow these steps.

  1. Follow steps 1-3 for creating the problem in the simple editor.

  2. Select Advanced Editor. The advanced editor opens the template and shows the OLX markup that you can use for this problem type.

  3. Replace the guidance provided by the template to add your own text. For example, replace the question or prompt, answer options, and explanation.

    To format equations, you can use MathJax. For more information, see Using MathJax for Mathematics.

  4. Update the OLX to add optional elements and attributes required for your problem.

  5. Select Settings to provide an identifying Display Name and define settings for the problem. For more information, see Defining Settings for Problem Components.

  6. Select Save.

10.13.3. Adding Feedback to a Dropdown Problem¶

For an overview of feedback in problems, see Adding Feedback and Hints to a Problem. You can add feedback for each of the answer options you provide in the problem. Use the following guidelines when providing feedback.

  • Use feedback for the incorrect answers to target common misconceptions and mistakes.

  • Ensure feedback provides some guidance to the learner about how to arrive at the correct answer.

  • Use feedback for the correct answer to reinforce why the answer is correct. Because learners are able to guess, ensure that feedback provides a reason why the answer is correct for learners who might have selected that answer by chance.

You can add feedback in a dropdown problem using the simple editor or the advanced editor.

10.13.3.1. Configuring Feedback in the Simple Editor¶

You can configure feedback in the simple editor. When you add a dropdown problem, select the template Dropdown with Hints and Feedback. This template has example feedback syntax that you can replace.

[[
Wrong Answer {{Feedback for learners who select this answer.}}
Wrong Answer {{Feedback for learners who select this answer.}}
(Correct Answer) {{Feedback for learners who select this answer.}}
]]

Note

When you include feedback, you might find it more convenient to use new lines to separate the answer options.

For example, the following problem has feedback for each possible answer.

>>A/an ________ is an example of a vegetable.<<

[[
  apple {{An apple is the fertilized ovary that comes from an apple tree and
    contains seeds classifying it as a fruit.}}
  pumpkin {{A pumpkin is the fertilized ovary of a squash plant and contains
    seeds classifying it as a fruit.}}
  (potato) {{A potato is an edible part of a plant in tuber form and is
    classified as a vegetable}}
  tomato {{Many people mistakenly think a tomato is a vegetable. However,
    because a tomato is the fertilized ovary of a tomato plant and contains
    seeds it is classified as a fruit.}}
]]

10.13.3.2. Configuring Feedback in the Advanced Editor¶

In the advanced editor, you configure answer feedback with the following syntax.

<option correct="False">Option Label
  <optionhint>Feedback for when a learner selects this incorrect answer.</optionhint>
</option>

For example, the following problem has feedback for each answer.

<problem>
  <optionresponse>
    <label>A/an ________ is an example of a vegetable.</label>
    <optioninput>
      <option correct="False">apple
        <optionhint>An apple is the fertilized ovary that comes from an
         apple tree and contains seeds classifying it as a fruit.</optionhint>
      </option>
      <option correct="False">pumpkin
        <optionhint>A pumpkin is the fertilized ovary of a squash plant and
         contains seeds classifying it as a fruit.</optionhint>
      </option>
      <option correct="True">potato
        <optionhint>A potato is an edible part of a plant in tuber form and
         is classified as a vegetable.</optionhint>
      </option>
      <option correct="False">tomato
        <optionhint>Many people mistakenly think a tomato is a vegetable.
         However, because a tomato is the fertilized ovary of a tomato plant
         and contains seeds it is classified as a fruit.</optionhint>
      </option>
    </optioninput>
  </optionresponse>
</problem>

10.13.3.3. Customizing Feedback Labels¶

By default, the feedback labels shown to learners are Correct and Incorrect. If you do not define feedback labels, learners see these terms when they submit an answer, as in the following example.

Incorrect:
An apple is the fertilized ovary that comes from an apple tree and contains
seeds classifying it as a fruit.

You can configure the problem to override the default labels. For example, you can configure a custom label for a specific wrong answer.

Not Quite:
Many people mistakenly think a tomato is a vegetable. However, because a
tomato is the fertilized ovary of a tomato plant and contains seeds it is
classified as a fruit.

Note

The default labels Correct and Incorrect display in the learner’s requested language. If you provide custom labels, they display as you define them to all learners. They are not translated into different languages.

10.13.3.3.1. Customize Feedback Labels in the Simple Editor¶

In the simple editor, you configure custom feedback labels with the following syntax.

[[
Incorrect Answer {{Label:: Feedback for learners who select this answer.}}
.
.
.
]]

That is, you provide the label text, followed by two colon (:) characters, before the feedback text.

For example, the following feedback is configured to use a custom label.

[[
tomato {{Not Quite:: Many people mistakenly think a tomato is a
vegetable. However, because a tomato is the fertilized ovary of a tomato
plant and contains seeds, it is a fruit.}}
.
.
.
]]

10.13.3.3.2. Customize Feedback Labels in the Advanced Editor¶

In the advanced editor, you configure custom feedback labels with the following syntax.

<option correct="False">Answer
  <optionhint label="Custom Label">Feedback for learners who select this answer.</optionhint>
</option>

For example, the following feedback is configured to use a custom label.

<option correct="False">tomato
  <optionhint label="Not Quite">Many people mistakenly think a tomato is a
   vegetable. However, because a tomato is the fertilized ovary of a tomato
   plant and contains seeds it is classified as a fruit.</optionhint>
</option>

10.13.4. Adding Hints to a Dropdown Problem¶

You can add hints to a dropdown problem using the simple editor or the advanced editor. For an overview of hints in problems, see Adding Feedback and Hints to a Problem.

10.13.4.1. Configure Hints in the Simple Editor¶

In the simple editor, you configure hints with the following syntax.

||Hint 1||
||Hint 2||
||Hint n||

Note

You can configure any number of hints. The learner views one hint at a time and views the next one by selecting Hint again.

For example, the following problem has two hints.

||A fruit is the fertilized ovary from a flower.||
||A fruit contains seeds of the plant.||

10.13.4.2. Configure Hints in the Advanced Editor¶

In the advanced editor, you add the <demandhint> element immediately before the closing </problem> tag, and then configure each hint using the <hint> element.

.
.
.
<demandhint>
  <hint>Hint 1</hint>
  <hint>Hint 2</hint>
  <hint>Hint 3</hint>
</demandhint>
</problem>

For example, the following OLX for a multiple choice problem shows two hints.

.
.
.
</multiplechoiceresponse>
<demandhint>
  <hint>A fruit is the fertilized ovary from a flower.</hint>
  <hint>A fruit contains seeds of the plant.</hint>
</demandhint>
</problem>

10.13.5. Dropdown Problem OLX Reference¶

10.13.5.1. Template¶

<problem>
  <optionresponse>
    <label>Question or prompt text</label>
    <description>Optional information about how to answer the question</description>
    <option correct="False">Option Label
      <optionhint>Feedback for when learner selects this answer.</optionhint>
    </option>
    <option correct="True">Option Label
      <optionhint>Feedback for when learner selects this answer.</optionhint>
    </option>
    <solution>
      <div class="detailed-solution">
        <p>Explanation or Solution Header</p>
        <p>Explanation or solution text</p>
      </div>
    </solution>
  </optionresponse>
  <demandhint>
    <hint>Hint 1</hint>
    <hint>Hint 2</hint>
    <hint>Hint 3</hint>
  </demandhint>
</problem>

10.13.5.2. Elements¶

For dropdown problems, the <problem> element can include this hierarchy of child elements.

<optionresponse>
    <label>
    <description>
    <optioninput>
          <option>
              <optionhint>
    <solution>
<demandhint>
    <hint>

In addition, standard HTML tags can be used to format text.

10.13.5.2.1. <optionresponse>¶

Required. Indicates that the problem is a dropdown problem.

10.13.5.2.1.1. Attributes¶

None.

10.13.5.2.1.2. Children¶
  • <label>

  • <description>

  • <optioninput>

  • <solution>

10.13.5.2.2. <label>¶

Required. Identifies the question or prompt. You can include HTML tags within this element.

10.13.5.2.2.1. Attributes¶

None.

10.13.5.2.2.2. Children¶

None.

10.13.5.2.3. <description>¶

Optional. Provides clarifying information about how to answer the question. You can include HTML tags within this element.

10.13.5.2.3.1. Attributes¶

None.

10.13.5.2.3.2. Children¶

None.

10.13.5.2.4. <optioninput>¶

Required. Designates an answer option.

10.13.5.2.4.1. Attributes¶

Attribute

Description

options

Either this attribute or a set of <option> child elements for <optioninput> is required. Accepts a comma separated list of values in the following format.

options="('Answer1','Answer2','Answer3')"

correct

Used if the options attribute is set. Required. Indicates which of the answer options is correct.

10.13.5.2.4.2. Children¶
  • <option>

  • <optionhint>

10.13.5.2.5. <option>¶

Designates an answer option. Either a set of <option> child elements or the options attribute for <optioninput> is required.

10.13.5.2.5.1. Attributes¶

Attribute

Description

correct

Required. Indicates whether the answer option is correct or incorrect. When set to "true", the choice is a correct answer. At least one required. When set to "false", the choice is an incorrect answer.

If the <option> element is used, <optionhint> is a child of <option>.

10.13.5.2.6. <optionhint>¶

Optional. Specifies feedback for the answer.

10.13.5.2.6.1. Attributes¶

None.

10.13.5.2.6.2. Children¶

None.

10.13.5.2.7. <solution>¶

Optional. Identifies the explanation or solution for the problem, or for one of the questions in a problem that contains more than one question.

This element contains an HTML division <div>. The division contains one or more paragraphs <p> of explanatory text.

10.13.5.2.8. <demandhint>¶

Optional. Specifies hints for the learner. For problems that include multiple questions, the hints apply to the entire problem.

10.13.5.2.8.1. Attributes¶

None.

10.13.5.2.8.2. Children¶

<hint>

10.13.5.2.9. <hint>¶

Required. Specifies additional information that learners can access if needed.

10.13.5.2.9.1. Attributes¶

None.

10.13.5.2.9.2. Children¶

None.

Next Previous

Copyright © 2022, edX Inc.
Creative Commons License
These works by edX Inc. are licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.