Open edX Learner’s Guide: Ficus Release

Welcome!

Welcome to online learning with edX! At edX, we are glad to welcome new learners to the edx.org website or to the edX mobile app, as well as to all of the other websites that use the Open edX platform to deliver courses around the world. We hope that you are as excited about online learning as we are.

The purpose of this guide is to help with your transition to online learning. The guide answers common questions about topics like getting started in an online course, earning certificates, participating in course discussions, and completing some of the exercises you may see in your course.

This guide is continuously being updated and expanded, so we encourage you to let us know what was helpful, and what was not, by selecting Feedback on any page or by sending an email message to docs@edx.org.

Learning in a MOOC

A massive, open, online course (MOOC) typically uses videos and text to present course content, although you might also encounter other types of reading assignments, such as textbooks and online articles. A MOOC also includes assessments, in the form of practice questions, homework assignments, and exams. To help you share information, ask questions, and collaborate with other learners and the course team, course discussions are available.

Videos and other types of course content, assessments, and discussions are used in virtually every MOOC on the edx.org website. These course components are also used to create the courses on websites that use the Open edX online learning platform. Everyone is welcome to review examples of these components, and practice using them, by enrolling in the edX Demo course.

Depending on the course, a variety of enhanced components might also be included, from team problem-solving exercises and lab work to live demonstrations and ask me anything (AMA) sessions. Every course has a unique design, and course teams are continuously looking for new ways to engage learners and teach more effectively. Course teams typically include instructions for how to use any enhanced components right in the course.

MOOCs bring learners from all over the world together. The people who you take a course with have a wide variety of educational backgrounds and educational goals. One part of the MOOC experience that everyone shares is encountering new ways of learning. As a result, most learners occasionally have questions about what is expected, how to complete an assignment, or what a word, phrase, or abbreviation means.

If you have a question about something you encounter in an edX course, try these options for getting an answer.

  • Check the Home page. Course teams use this page to post updates about the course, which can include explanations about course content, reminders about when graded assignments are due, or announcements for upcoming events or milestones.
  • Look for an “Introduction”, “Overview”, or “Welcome” section on the Course page. Course teams often include general information about how the course works and what you can expect, and also what they expect from you, in the first section in the course.
  • Participate in the course discussions. If you encounter an unfamiliar word, phrase, or abbreviation, such as “finger exercise” or “board work”, search for it on the Discussion page, or post a question about it yourself. Other learners might be able to answer your question, or might have the same question themselves. Your comments and questions give the course team useful feedback for improving the course.
  • Investigate other resources. Within the course, a wiki, if one is available, can be a good source of information. Outside of the course, a course-specific Facebook page or Twitter feed might be available for learners to share information.

A Note about Time Zones

The dates and times that new materials are released, and when homework assignments and exams are due, are shown throughout your course.

In your account settings, you can select your local time zone so that any course dates and times are displayed in your local time.

Important

If you do not select a time zone in your account settings, edX lists dates and times on your dashboard, in the body of the course, and on your Progress page in the time zone that your browser settings specify. Other times and dates appear in Coordinated Universal Time (UTC). Dates and times that use your browser time zone are in military time and are followed by a time zone indicator: for example, 17:00 Sept 16, 2018 IOT. Dates and times in UTC do not have a time zone indicator.

To convert UTC time to your local time, you can use any time zone converter that you want, including one of the following time zone converters.

Enrolling in a Course

This section provides guidelines for course enrollment. Different websites can offer different options for enrollment.

Enroll in a Course

After you decide that you want to learn in an online course, you enroll in that course.

To enroll in a course, follow these steps.

  1. In the course catalog on the main website, select the course that you want to take.

  2. When the About page for the course opens, select Enroll Now.

    For some courses, different enrollment options might be available, such as a free audit track or a paid certificate track. If the course offers different enrollment options, select an option.

  3. If you are using a web browser, your course dashboard opens with a list of all of the courses you are enrolled in. To open the course, select View Course.

    If you are using the edX mobile app, the new course opens immediately.

Start a Course

As soon as you enroll in a course, you can access information about the course and change course-specific settings on your dashboard.

After the course start date, you can start working in the course.

For more information, see Starting a Course.

Working with Your Dashboard, Settings, and Profile

Exploring Your Dashboard, Settings, and Profile

This topic describes tasks you can complete on your dashboard, and on the account settings and profile pages.

Overview

After you create an account, you can view information about your courses, change course or account settings, or create a profile.

You can access course, account, or profile information from any page on the website, whether you are in a course or browsing the course catalog. Select the dropdown menu icon next to your username, and then choose one of the following menu options.

  • Dashboard gives you access to your courses and to course information, such as start and end dates, certificates, and email settings.
  • Profile gives you the option to provide personal information about yourself for that other course participants, such as an image and biographical information.
  • Account gives you access to your account settings and preferences. For example, you can update your password or email address and set your time zone.

Accessing Your Courses from the Dashboard

Your dashboard lists all of the courses that you are enrolled in. When you create an account or enroll in a course, you automatically go to your dashboard. You can also access your dashboard by selecting the dropdown menu icon next to your username at the top of any page.

The menu that appears on the website when you select the dropdown icon next to your username. The Dashboard option is circled, and the other options are Profile, Account, and Sign Out.

You can find information about your courses and change course settings on your dashboard. For more information, see Updating Course-Specific Settings.

Starting a Course

This section describes how to start a course and begin doing course work, and how to change settings that apply to a specific course.

As soon as you enroll in a course, you can access some information about the course and change course-specific settings on your dashboard. You cannot access course lessons or assignments.

After the course start date, you can start working in the course.

Find a Course’s Start Date

Often, you can enroll in a course before it actually starts. You can find the course start date on your dashboard; however, the exact time is not published.

  • You do not need to sign in exactly when the course begins.
  • If the course content is not immediately available, check back later on the start date.

To find the course start date, follow these steps.

  1. At the top of any page, select the dropdown menu icon next to your username.
  2. Select Dashboard. Your dashboard lists every course that you are enrolled in.
  3. Locate the course in the list of courses on your dashboard.
    • For courses that have not yet started, “Starts” and the date appear below the name of the course.
    • For courses that are already in progress, “Started” and the date appear.
    • If the course team has not yet announced the start date, a message such as “Coming Soon” appears.
    • For archived courses that are no longer running, “Ended” and the date appear.
Start a Course

To start work in a course that is in progress, follow these steps.

  1. On your dashboard, locate the course.
  2. Select View Course. The course Home page opens. This page shows important dates and, typically, a welcome message from the course team.
  3. Select Course. The first section of course content opens.
View an Archived Course

You can enroll or continue to work in some courses even after the course end date. These courses are archived, which means that while you can access the course content, you cannot submit answers for graded problems or participate in course discussions.

To view the content of an archived course, follow these steps.

  1. On your dashboard, locate the course.
  2. Select View Archived Course.
View a Course Grade

To view your current grade in a course that has not yet ended, see Checking Your Progress in a Course.

To view your final grade in a course that you have completed, follow these steps.

  1. On your dashboard, locate the course. Your final grade appears under the course name.
  2. Optionally, print your dashboard to obtain a record of your achievement in the course.

You can also view the course and open its Progress page to view your final grade, as well as your grades on all course assignments.

Access a Certificate

If you earn a certificate for a course, options to access your certificate are available on your dashboard soon after the course ends. For more courses, certificates are available within two weeks.

To access the certificate that you have earned in a course, locate the course on your dashboard. Next to the course name is an option for accessing the certificate. For example, the option might be View Certificate or Download Your ID Verified Certificate (PDF).

For information about how to access certificates, including how to download certificates, see Getting a Course Certificate or Badge.

Updating Course-Specific Settings

This section describes how you update course-specific settings.

Change a Course Email Preference

To change your email preference for a course, follow these steps.

  1. On your dashboard, locate the course.

  2. Select the course settings icon. The course settings icon resembles a gear and appears next to View Course or View Archived Course.

    The course settings icon next to the View Course button on the learner dashboard.
  3. Select Course emails.

  4. Select or clear the Receive course emails check box, and then select Save Settings.

    Note

    If you clear this check box, you will not receive any of the email messages that course teams send to communicate with enrolled learners in the course.

Unenroll from a Course

If you find that you cannot complete a course, you can stop viewing and working in the course. You do not have to drop or unenroll from the course.

If you unenroll, the course no longer appears on your dashboard, and you cannot access course content or information about the grade or certificate you might have earned in the course.

To unenroll from a course, follow these steps.

  1. On your dashboard, locate the course.

  2. Select the course settings icon.

    A learner's dashboard of courses with the course settings menu open for a course. An arrow indicates the Course Settings icon, and the Unenroll menu option is circled.

If you change your mind before the course ends, you can enroll in the course again. Your status in the course, including your scores for all completed assignments, is available as soon as you re-enroll.

Updating Your Account Information

You can find and update information about your account on the account settings page. You access your account settings page by selecting the dropdown menu icon next to your username at the top of any site page.

The menu that appears on the website when you select the dropdown icon next to your username. The Account option is circled, and the other options are Dashboard, Profile, and Sign Out.

The account settings page presents information in these categories.

  • Account Settings provides access to information about your account.

    Note

    You cannot change your username.

  • Linked Accounts lists social media and other accounts that you can connect to your account.

  • Order History lists information about payments you have made, such as fees for verified certificates. For more information, see Verify a Payment.

You can view this information at any time. You can also make changes to keep information about yourself up to date.

Change Your Password

To change your password, follow these steps.

  1. At the top of any page, select the dropdown menu icon next to your username.

  2. Select Account.

  3. Select Reset Password.

    The system sends a confirmation message to the email address in the Email Address field.

  4. Select the confirmation link in the email message.

Update Your Email Address

You use your email address to sign in to your account. In addition, communications from your course teams are sent to this address.

To update your email address, follow these steps.

  1. At the top of any page, select the dropdown menu icon next to your username.
  2. Select Account.
  3. In the Email Address field, select your current email address and replace it with the new address.
  4. To save your changes, click anywhere on the page outside of the Email Address field, or navigate to a different page.
Change Your Full Name

Your full name appears on the certificates that you earn. Other learners see only your username. They do not see your full name.

To change your full name, follow these steps.

  1. At the top of any page, select the dropdown menu icon next to your username.
  2. Select Account.
  3. In the Full Name field, make the revisions that you require.
  4. To save your changes, click anywhere on the page outside of the Full Name field, or navigate to a different page.
Select a Language

You can specify the language that you want the site to use during your visits.

Note

This setting changes the appearance of menu options, button labels, and other elements of the site’s user interface. It does not apply to course content.

To select a language, follow these steps.

  1. At the top of any page, select the dropdown menu icon next to your username.

  2. Select Account.

  3. Select a Language. The site saves your selection immediately.

    The website is currently available in a limited number of languages.

Select Your Time Zone or Location

You can select the time zone that you want course dates and times to appear in, and update the country or region where you live.

Note

If you do not select a time zone, course dates and times in the body of the course, on your Progress page, and on your dashboard display in the time zone that your browser settings specify. Other dates and times display in Coordinated Universal Time (UTC). Dates and times that use your browser time zone are in military time and are followed by a time zone indicator: for example, 17:00 Sept 16, 2018 IOT. Dates and times in UTC do not have a time zone indicator.

To select your time zone or location, follow these steps.

  1. At the top of any page, select the dropdown menu icon next to your username.
  2. Select Account.
  3. Select a Time Zone. The site saves your selection immediately.
  4. Select a Country or Region. The site saves your selection immediately.
Specify Additional Information

Additional account information is optional and includes the following information.

  • Education Completed: The highest level of education that you have completed.
  • Gender: The gender you identify as.
  • Year of Birth: The year that you were born.
  • Preferred Language: The language that you prefer to communicate in.

To view or change this information, follow these steps.

  1. At the top of any page, select the dropdown menu icon next to your username.
  2. On the Account Settings page, select Account Information.
  3. On the Account Information page, locate the Additional Information section, and then make your changes.

The site saves your changes automatically.

Adding Profile Information

Your personal profile allows you to specify information about yourself that you want to share with other participants in the courses that you take. Adding a profile is optional. If you add profile information, course teams and other learners in your courses can view the information that you share.

In addition to your username, your profile can include a picture, your location, and other biographical information.

You can share either a limited profile or a full profile.

  • A limited profile shares only your username and an optional profile picture.

    Note

    If you are under 13 years of age, you can only share a limited

    profile. You cannot share a profile picture.

    A learner's limited profile showing only username and image.
  • A full profile includes biographical information in addition to your username and profile image.

    A learner's full profile with location, language, and short biographical paragraph.
Add or Update a Limited Profile

A limited profile includes only your username and, optionally, an image.

Note

If you are under 13 years of age, your limited profile only includes your username. You cannot add a profile picture.

To add or update a limited profile, follow these steps.

  1. At the top of any page, select the dropdown menu icon next to your username.

  2. Select Profile.

  3. On your profile page, locate learners can see my, and then select Limited Profile.

  4. (optional) Add an image that you want to associate with your username. Your image must be a .gif, .jpg, or .png file. The image must be between 100 bytes and 1 MB in size. If you do not add an image, the placeholder image appears as your profile image.

    1. Move your cursor over the placeholder image, and then select Upload Image.
    2. In the dialog box, select the image file that you want, and then select Open.

    To change or remove your profile image, move your cursor over your image, and then select either Change Image or Remove. When you remove your profile image, the placeholder image appears as your profile image.

The site saves your changes automatically.

Add or Update a Full Profile

Note

You must specify your year of birth on the Account Settings page before you share a full profile. If you are under 13 years of age, you can share only a limited profile.

A full profile can include the following information. Your username and country or region are required.

  • Your username.
  • An image that you select to identify yourself.
  • Your country or region.
  • Your preferred language.
  • A paragraph about yourself. You might include your interests, goals, or other information that you want to share. This paragraph can contain up to 3000 characters.

To add or update your profile, follow these steps.

  1. At the top of any page, select the dropdown menu icon next to your username.

  2. Select Profile.

  3. Locate learners can see my, and then select Full Profile.

  4. On your profile page, move your cursor over the information that you want to add or change.

    If you have not added information to the field, the field appears highlighted and surrounded by a dashed line.

    A profile page with the "Add language" field highlighted and surrounded by a dashed line.

    If the field already has information, the field appears highlighted, and a pencil icon appears.

    A profile page with the "About Me" field highlighted.
  5. Move your cursor inside the field, and then either enter text in the field or select a different option from a list.

The site saves your changes automatically.

Note

If you change the profile type selection from Full Profile to Limited Profile, your location, language, and descriptive paragraph are not visible on your profile page. However, this information is saved. To make this information visible again, select Full Profile.

View Another Learner’s Profile

You can view other learners’ profiles through their posts, responses, or comments in course discussions.

  1. On the Discussion page, select the username of any learner in a post, a response, or a comment.

    A page that displays the discussion activity only for the selected learner opens.

  2. On the learner’s Discussion page, select their linked username.

The learner’s account profile page opens.

Deactivate Your Account

To deactivate your account, you unenroll from all of your courses. You can reactivate your account at any time by enrolling in a new course.

If You Use the edX Mobile App

This topic answers questions about how you can use the edX mobile app on an Android smartphone or an iPhone to take edX courses.

Overview of the edX Mobile App

You can use the app to download course videos so that you can watch them whenever you want to, even without an Internet connection. When you have an Internet connection, you can also read course announcements, participate in course discussions, and get started on homework and other assignments. To complete an entire course, you use a web browser on a computer.

Course Questions

Can I take a course entirely on my mobile device?

The answer depends on the types of problems that are used in the course you are taking. If a course contains mobile friendly problem types, you can complete those types of problems using the mobile app. For a list of the types of problems you can complete using the mobile app, see What types of problems can I do in the mobile app?. Timed exams and proctored exams cannot be taken using the mobile app.

You can watch course videos on the mobile app, and can also download videos to your mobile device for watching when you do not have an internet connection. When you have an internet connection, you can also read course announcements, participate in course discussions, and complete the mobile friendly problems in your assignments.

To complete an entire course, you can use a web browser on a computer.

Can I use the edX mobile app to do my homework?

You can use the edX mobile app to do some, but not all, of the problems in your assignments. EdX courses include a variety of problem types. Currently, you can read questions and submit answers only for problem types that require relatively simple actions as responses.

For example, you can use the edX app to answer multiple choice questions, but you cannot use it to draw molecules or design circuits. To complete problems that require complex actions, you must use a web browser.

Note

EdX recommends that you complete all of your graded assignments in a web browser on a computer.

What types of problems can I do in the mobile app?

In the edX mobile app, you can do problems that you answer in one of these ways.

  • Checkbox selection
  • Drag and drop selection
  • Dropdown list selection
  • Multiple choice selection
  • Math expression input
  • Numerical input
  • Text input

Timed or proctored exams cannot be taken using the mobile app.

How do I post questions on the discussion board?

You can read and contribute to course discussions in the edX mobile apps whenever you have an Internet connection. In your course, select Discussion. You can then browse through different topics or search for words or phrases that interest you. For information about course discussions, see Participating in Course Discussions.

Video Questions

How do I download videos?

To download videos, you must be connected to the Internet. Select the “download” icon that appears to the right of a subsection or video name.

  • If you select download for a subsection, you download all of the videos in that subsection.

  • If you select download for a video, you download only that video.

    This example lists subsections in a course and shows how many videos will download when you select the icon.

    List of subsections with the "download" icon circled.

To download videos, you must be connected to the Internet. After you download a video, you can watch it at any time.

How much data will the videos in this app use?

Course videos are optimized for mobile playback, but watching or downloading any video can result in heavy data use. EdX recommends using a Wi-Fi connection if you intend to watch or download a lot of videos. The edX mobile apps have a Download only on Wi-Fi setting that is enabled by default to help you avoid using your cellular network accidentally.

What are the numbers to the right of subsection names?

The number to the right of a subsection name indicates the number of videos in that subsection.

How can I make the video full screen?

Rotate your phone until the video changes to landscape mode, or select “full screen” in the bottom right corner of the video player.

Video with "full screen" icon circled.

Can I speed up the videos?

You can change video speeds on the iPhone app. While a video plays, select Settings (the “gear” icon) at the lower right, and then select Video Speed.

On the Android app, videos currently play only at their original speeds.

How do I change my download settings?

  1. On the My Courses page, select the menu in the upper left corner.

    Mobile "My Courses" page with an arrow pointing to the menu in the upper left corner.
  2. Select My Settings.

  3. Change the Wi-Fi only download setting.

Note

By default, the apps are set so that they only download content, including videos, if you are on a Wi-Fi network. If you change this setting, you might exceed the data allowance for your cellular plan.

How do I delete downloaded videos?

  1. On the My Courses page, select the menu in the upper left corner.
  2. Select My Videos.
  3. On the All Videos page, select the course that has the video that you want to delete. Alternatively, select Recent Videos.
  4. At the bottom of the list of videos, select Edit. A “selection” icon appears next to each video name and at the top of the page.
  5. Select the videos that you want to delete. To select all of the videos, select the icon at the top of the page.
  6. Select Delete.

What are the circles to the left of the video names?

Each circle indicates whether you have already played a video. A blue circle means that you have not started playing the video. A half-filled circle means that you played part of the video. A gray circle means that you played the entire video.

Notification Questions

Will I get notified about upcoming due dates and exams?

Many course teams send notifications to remind you when assignments are due or make other announcements. However, each course team decides what to announce and when, and whether to send notifications to the mobile app.

Where can I read all of the announcements for my course?

You can use the edX mobile app or a web browser to visit the Home page and read all of the announcements.

How do I turn off course notifications (or turn them back on)?

You can turn notifications off, or on, for each of your courses. In the edX mobile app, select the course and visit its Home page to change the notification setting.

Can I turn off notifications for all of my courses at once?

You can turn off all notifications for the edX mobile app. To change the notification setting on an Android smartphone, visit the App info page for the edX mobile app. On an iPhone, visit Settings and then select the edX mobile app.

Troubleshooting

I see “This video is not available” when I try to watch a video. What can I do?

If you have problems viewing videos, make sure that you have an Internet connection and then try to view or download the video again.

If problems persist, let us know. On the My Courses page, select the “menu” icon, and then select Submit Feedback.

Checking Your Progress in a Course

This topic describes how to check and understand your progress in a course.

The Progress Page

As you work through a course, you can track your the scores on individual problems as well as your current overall course grade. Select Progress in any course.

Grading Chart

On the Progress page, a chart shows how you have performed for each graded assignment in the course.

Assignments are listed along the horizontal axis, and the percentage score that you received in each lesson is read from the vertical axis.

Bar chart on the Progress page showing graded assignments on the horizontal axis, and percentage scores on the vertical axis.

Markers on the vertical axis reflect the grading scale for the course. For example, if the passing percentage score for the course is 60%, there is a marker on the vertical axis at 60% so that you can compare your total score with the required passing score. If the course awards a grade of B for scores of 50% and higher, and a grade of A for scores 75% and higher, then there are markers on the vertical axis at 50% and 75%, labelled “B” and “A” respectively.

Note

In the progress chart, assigments are grouped by type. For example, all homework sections are listed together, then all quizzes, then exams.

The bar for each assignment reflects your total score for all the problems in that assignment. For individual problem scores, see Grading Details below the chart.

Some courses allow some number of graded assignments to be automatically dropped from your final score. For example, out of 8 quizzes, a course might have the lowest scoring quiz excluded from all learners’ final scores. A dropped assignment is indicated in the chart by an x above the horizontal axis.

Bar chart on the Progress page showing an "x" above an assignment whose score has been dropped.

Grading Details

The Progress page includes your scores for individual problems within an assignment. Below the grading chart is a listing of course sections in the order that they occur in the course.

For each problem in a graded assignment, the points that you earned out of the possible points is shown with the label Problem Scores. Scores for ungraded problems are shown with the label Practice Scores. Sections that do not have any problems are labelled as having no problem scores.

List of graded sections in the order that they occur in the course, showing earned and possible points for each graded problem.

Getting a Course Certificate or Badge

Your course might be set up to issue certificates as evidence that you successfully completed the course. Different types of certificates might be available for courses you take. For information about the certificates that your course offers, contact the course team or institution that created your course.

In addition, you might be able to earn badges for achievements such as completing a course or a series of courses, or for participating in course activities. The badges that you can earn depend on how badges have been set up for the course platform that you are taking a course on.

Accessing a Certificate

Some courses issue certificates, which you can access from your dashboard.

The following examples show the View Certificate option on a learner dashboard on the edx.org website and on the mobile app.

Dashboard with course name, grade, and link to the web certificate. "View certificate" button on the mobile app course page.

To open a web certificate in your browser, select View Certificate. You can then share or print your web certificate.

Share a Web Certificate

You can share your web certificates on Facebook, LinkedIn, and Twitter.

  1. Make sure that you are logged in to the social site on which you want to share your web certificate.

  2. In a different browser tab or window, open your web certificate.

  3. Select the social icon at the top of your web certificate.

    A dialog box for the social site you selected opens, with the certificate URL already entered.

    On the mobile app, select the Share icon to open a page from which you choose the social network to share your certificate to.

Choose the social network to which you want to share your certificate.
  1. Complete the steps for the social site to post your web certificate.

Viewing Earned Badges in Your Profile

If badges are available for your courses, you can see the badges you have earned in the Accomplishments section of your profile.

A user profile showing the Accomplishments tab

Sharing Badges on Mozilla Backpack

You can share any badge that you earned, including certificate badges, to a badging site such as Mozilla Backpack.

Share Badges From Your Profile

To share badges from your profile to the Mozilla Backpack site, follow these steps.

Note

You have to create an account on Mozilla Backpack before you can share your badges.

  1. On your profile, select Accomplishments.

  2. For the badge that you want to share, select Share, or on the edX mobile apps, select the Share icon.

    The following examples show the Share options for badges on the edx.org website and on the mobile app.

The Mozilla Backpack share button is available for each badge on the Accomplishments section of your user profile page. Choose the social network to which you want to share your certificate.

You see instructions for downloading your badge and then sharing it on the Mozilla Backpack site.

Dialog with instructions that opens when you select the Mozilla Backpack share icon.

Share Certificate Badges

Some courses that offer web certificates allow you to download a badge that represents the certificate, and then share that badge on a badging site such as Mozilla Backpack. You can download your badge as soon as your web certificate appears on your dashboard. Many courses distribute web certificates within two weeks of the course end date.

To share your web certificate on the Mozilla Backpack site, follow these steps.

  1. On your dashboard, locate the course that you want, and then select View Certificate.

    If this option is not available, the course might not have distributed certificates yet. Check your dashboard again in a few days.

  2. On the certificate web page, select the badge sharing icon.

Icon bar at the top of the certificate web view, showing the Mozilla Backpack share icon.

You see instructions for downloading your badge and then sharing it on the Mozilla Backpack site. You have to create an account on Mozilla Backpack before you can share your badge.

Dialog with instructions that opens when you select the Mozilla Backpack share icon.

Taking a Self-Paced Course

Many courses are instructor-paced: they follow a schedule that the instructor sets, with assignments and exams that have specific due dates. In contrast, self-paced courses allow you to progress through the course at your own speed.

Differences between Instructor- and Self-Paced Courses

Instructor-paced courses follow a set schedule. Course materials become available at specific times as the course progresses. Assignments have due dates, and exams have start and end dates. On the Course page, indicators show when you have a graded assignment, as well as the due date for the assignment.

Part of the course navigation pane in an instructor-paced course, with due dates visible for homework.

Self-paced courses do not follow a set schedule. Course materials do not become available according to a schedule, but are completely available as soon as the course begins. Assignments and exams do not have start or due dates. The course shows indicators for graded assignments, but not due dates.

Part of the course navigation pane in a self-paced course, with no homework due dates.

In self-paced courses, you can submit an assignment or exam at any time before the course end date.

Searching the Course

This topic describes how to search for edX course content.

Search a Single Course

To search for a term in a single course, go to the Course page for that course, enter your search term in the Search field in the upper left corner of the page, and then press Enter. Your search term can contain more than one word.

After you press Enter, your search results appear in the right pane. The search results include the following items.

  • Your search term.
  • A brief excerpt from the surrounding text.
  • The place in the course where the search term appears.

To view your search term in the body of the course, select View to the right of the search result.

Note

You cannot use the Search field on the Course tab to search course discussions. To search course discussions, use the Search all posts field on the Discussions tab. For more information, see Participating in Course Discussions.

Search All Your Courses

You can search for a term across all your edX courses. To do this, go to your dashboard, enter your search term in the Search Your Courses field in the upper right corner of the page, and then press Enter. Your search term can contain more than one word.

After you press Enter, your search results appear on the Search Results page. The search results include the following items.

  • A brief excerpt from the text surrounding your search term, with your search term in bold.
  • The name of the course and the place in the course where the search term appears.
  • The type of content, such as text or video, that contains the search term.

To view your search term in the body of the course, select View to the right of the search result.

Completing Course Prerequisites

This topic describes how to complete any prerequisites that might be required in your edX course.

Overview of Prerequisites

Some edX courses require that you have a particular set of skills or knowledge before you begin the course. Many courses include information about these general requirements on their About pages.

In addition to requiring general skills and knowledge, some courses require learners to pass a specific prerequisite edX course or pass an entrance exam.

Prerequisite edX Course

When a course has a prerequisite edX course, you can see information about the prerequisite course on the About page for the course that you want to take.

A course About page with prerequisite course information circled.

It is possible to enroll in the course even if you have not taken the prerequisite course. When you enroll in the course, the course appears on your Student Dashboard. However, you cannot select the course to access the course content. Below the name of the course, you can see the name of the prerequisite course, as well as a link to that course.

The Student Dashboard with an available course and a course that is unavailable because it has a prerequisite.

When you select the link, the About page for the prerequisite course opens. You can then enroll in the prerequisite course.

After you successfully complete the prerequisite course, the other course becomes available on your dashboard, just like other edX courses. You can then select the course to access any available materials.

Entrance Exam

If you enroll in a course that requires an entrance exam, the course appears on your Student Dashboard. However, you cannot access all released course content immediately.

The first time that you access the course, the course opens to the Entrance Exam page. At the top of the page, you can see a message that lists your current score and the minimum score that is required to pass the entrance exam. You can begin the exam immediately.

The Entrance Exam page with the first problem visible.

To take the exam, answer all the available questions, and then select Submit to submit your answers.

To see your score on the exam, refresh the page after you submit your answers. The message at the top of the page tells you if you have passed the exam. If you refresh the page before you answer all the questions in the exam, the message tells you your current score.

After you pass the entrance exam, in addition to the message at the top of the page, you can see all of the currently available course sections in the course navigation pane, and you can access all available course materials.

The course team can allow learners to skip the entrance exam. If a course team member allows you to skip the entrance exam, you do not see the entrance exam when you access the course.

Understanding Course Content Availability and Scheduling

When you begin a course, on the Course page you can see the sections of the course content in the course navigation pane. You can view the sections in the course, select each one to view its subsections, and select the subsections to view the course material .

In some courses, all of the sections of the course content are visible in the course navigation pane when you open the course for the first time. In other courses, additional content becomes available as you work, either because it was scheduled for release on a specific date, or because you completed required content that allowed you to proceed to further content.

  • In some courses, the course team schedules the dates on which the sections of the course content become available to you. On the date that the course team chooses, the course content appears in the course navigation pane.
  • Some courses include content that has prerequisite sections. Prerequisite sections require that you complete other, previous sections before they become available. The course team sets a minimum score that you must earn in the problems of a prerequisite section in order to display the following sections.

Not all courses include scheduled course content or prerequisites. Your course might display all of the course content in the course navigation pane as soon as you begin taking it.

If you do not see the course content that you expect, you can check for information about the course schedule and content prerequisites on the course Home page or course discussions.

Watching Videos on the edX Video Player

All edX courses include videos, and edX has its own video player. Most of the controls on the player will be familiar to you if you have watched online videos before. However, the edX video player has some extra features you may not have seen.

The following image shows the video player in the middle of a video, followed by an explanation of each option or control on the video player.

Note

The illustration that follows shows the video player for a video that has all of the possible features available. Only the controls that apply to a specific video will actually be present when you use the video player in a course.

The edX video player with numbered call-outs for every possible control.
  1. Play/pause: You can play the video by selecting this control. Select this control again to pause the video.

  2. Time: The first number indicates the length of time the video has already played. The second number indicates the total length of the video.

  3. Playback bar: You can go to a different point in the video by selecting and dragging this control or by using the left and right arrow keys.

  4. Speed: If you want the video to play faster or slower, you can select different speeds using this control.

  5. Volume: You can use this control to change the volume of the video.

  6. HD: You can play the video in high-definition visual resolution by selecting this option if HD quality is available for the video. This option works best if you have a fast Internet connection. Select this control again to play the video in standard resolution.

  7. Full screen: You can expand the video to fill your browser window by selecting this control. To return to default mode, press ESC on your keyboard or select this control again.

  8. Show or hide closed captioning: You can show an overlaid transcript of the audio portion of the file by selecting this control. If you show the captions, you can move them to different areas on the video screen by dragging and dropping them. To hide the captions, select this control again.

    Note

    In some cases, two sets of captions can appear when you select CC. This situation can occur if YouTube is the host service for the video and your YouTube account settings for playback are set to always show captions. As a result, YouTube and your course might both provide captions for the video. To correct this problem, select CC again or change your YouTube account setting.

  9. Show transcript: You can show a complete, scrolling transcript of the audio portion of the file to the right of the video by selecting this control. Many course teams set video transcripts to play by default when your video starts. Select this control again to hide the transcript.

  10. Language menu: You can select a different language for the closed captions and the transcript with this control if translations are available.

    A language menu with choices for English or Chinese.
  11. Download video: You can download the video to watch later with this option (if available for the video).

  12. Download transcript: You can download the video’s transcript as a SubRip (.srt) file or as a text (.txt) file. You can open files of either type in a text editor such as Notepad.

  13. Handouts: You can download any handouts that the course team has associated with the video.

  14. License or Copyright: If the course team reserves rights or specifies a Creative Commons license for the video that is different from the course-wide license, that information appears below the video player. For Creative Commons licenses, you can select the license to open a web site with more information about your rights.

    For more information, see Understanding How Courses and Videos Are Licensed.

  15. Transcript: You can scroll through the transcript and select any line to go to that point in the video.

For a demonstration of the edX video player, see Videos on edX in the edX DemoX course.

Participating in Course Discussions

Course discussions give you the opportunity to start conversations with other learners, ask questions that other learners or the course team can answer, and participate in the course community.

This section provides information about course discussions that can make your participation more effective.

Anatomy of Course Discussions

This section describes the structure and elements of course discussions.

For information about how to participate in course discussions, see Taking Part in Course Discussions.

Basic Elements: Topics, Posts, Responses, and Comments

The following example shows the different ways that you can contribute to a discussion.

Post: "Please introduce yourself."
  - Response: "My name is Lee and I teach secondary school maths in Canberra,
    Australia."
  - Response: "Hello everyone, I am Sumei from Hong Kong, China."
    - Comment: "Hi Sumei, I am taking this course in Hong Kong too. Maybe we
      should make a study group!"
    - Comment: "I'd like to join the Hong Kong study group too, I think it
      will help me keep up with the homework."
  - Response: "Hi from Johannesburg! I am taking the course to prepare for my
    matric exams."

A post initiates the conversation, responses are replies to a post, and comments expand on specific responses. Before you add a post, response, or comment to your course discussion, take a moment to consider which of these options best suits the contribution that you want to make. This helps keep course discussions organized and easy to follow.

Every post is associated with a topic, chosen from the list of topics created by the course team. For information about topics, see Discussion Topics.

For more information about joining the discussions in your course, see Exploring Discussion Posts and Taking Part in Course Discussions.

Discussion Topics

Discussion topics are created by the course team and organize all posts in the course discussion. Discussion topics can be course-wide or content-specific.

  • Course-wide discussion topics cover matters that affect the entire course, and can include topics such as “Frequently Asked Questions” and “Troubleshooting”. In the discussion navigation pane, course-wide topics do not have other topics indented below them.
  • Content-specific discussion topics are added as part of a course unit, and relate to specific video lectures, reading assignments, homework problems, or other course content. In the discussion navigation pane on the Discussion page, content-specific topics are indented under an identifying category name.

For course-wide topics, you read or add posts, responses, and comments on the Discussion page. For content-specific discussion topics, you can read or add posts, responses, and comments both on the Discussion page and in the discussion that is embedded in the course unit on the Course page.

Before you add a post, look through the topics. When you add your post to the most appropriate topic, others with the same interest can find, read, and respond to it more easily.

Types of Discussion Posts

When you make a contribution in a course discussion topic, you add your post as either a question or a discussion.

  • A question post raises an issue so that members of the discussion administration team and the course community can provide answers.
  • A discussion post starts a conversation by sharing thoughts and reflections, and inviting community participation.

When you add a post to a discussion topic, you must specify whether it is a question or a discussion.

On the Discussion page for your course, a question mark icon identifies posts that ask questions and a conversation bubble icon identifies posts that start discussions.

If you have any difficulty deciding which type of post you want to add, think about whether you want to get concrete information (a question) or start an open-ended conversation (a discussion). If you require an answer from the course team, be sure to create your post as a question, so that the course team sees that a response is required and responds appropriately.

The Discussion Page

You browse and contribute to course discussions on the Discussion page for your course.

How to Use Discussions

The How to use edX discussions graphic appears in the main area of the Discussion page when you have not selected any topics or posts.

This graphic shows the basic actions you can take with course discussions. You can select the Receive updates option in the graphic to receive a daily email digest of new activity from course discussions.

The "How to use edX discussions" graphic on the Discussion page lists the basic actions you can take with course discussions, including filtering and sorting topics, voting on or following posts, and reporting abuse. You can select the "Receive updates" option in the graphic to receive a daily email digest of new activity from course discussions.

When you browse topics and posts from the Discussion Navigation Pane, the How to use edX discussions graphic is replaced by the contents of the topic or post that you selected.

Discussion Navigation Pane

Use the discussion navigation pane on the left side of the Discussions page to access discussion topics and posts in your course, including discussions that appear inline in course content.

You can view all discussion topics or only the posts that you are following, or you can view a specific topic. You can also filter posts by entering keywords or phrases that you want to find in post titles or text.

Use the navigation pane on the Discussion page to read posts in your course discussion. You can view all topics or only topics that you are following. You can also filter and sort posts, and you are notified about new unread responses and comments in posts.

The breadcrumb path above the navigation pane shows you the topic that you are currently viewing. In the following example, Posts I’m Following is selected.

Posts in the navigation pane have states and icons to indicate whether you have read them, and whether they are questions, discussions, or answered questions. Icons also indicate posts that you are following, that were pinned by discussion administrators, and that were posted by Staff or a Community Teaching Assistant.

When you view topics and posts, the navigation pane shows various icons and labels to provide you with information about the status or content of posts.

The discussion navigation pane, showing some unread and some read posts, including a post that has been read but now has additional new responses or comments.
  • Posts that appear in blue type with a blue bar indicate posts that you have not read.
  • Posts that appear in gray type without a bar indicate posts that you have read.
  • The post type icon indicates whether a post is a question or a discussion. For more information, see Determining the Post Type: Discussion or Question.
  • The check mark icon indicates a “correct answer”. The check mark icon indicates that one of the responses to the post correctly answers the question asked in the post.
  • The response or comment count indicator shows the number of responses and comments for a post. The number of new responses or comments that were added after you previously read a post is displayed next to the indicator. For more information, see Keeping Up with New Activity.
  • A “Pinned” label shows that a post has been pinned by administrators so that it always stays at the top of the topic list regardless of sort order.
  • A “Following” label marks posts that you are following.
  • A “Staff” or “Community TA” label marks posts that were added by course staff or community teaching assistants (TAs).

Exploring Discussion Posts

Finding out whether someone else has already asked the same question or initiated a conversation about the subject that interests you, and then reading and contributing to that exchange instead of starting a new one, helps make the time that everyone spends with the course discussions more productive. You can search for something specific, or you can browse through the posts in a single discussion topic.

For information about finding new or updated posts in discussions, see Keeping Up with New Activity.

Search Posts

To search for posts, responses, or comments containing a particular keyword or phrase, enter the word or phrase, or a partial word in the Search all posts field at the top of the Discussion page.

Search results are displayed in the discussion navigation pane. If an exact match is not found, search results are shown for a similar value.

You can also enter a username to search for posts added by a specific person. Select the linked username in the search result to show a list of posts made by that person. For more information about viewing contributions from a specific user, see View Contributions from a Specific Participant.

View Discussions about a Specific Topic

Course discussions are organized by discussion topics, which are created by the course team. Anyone who adds a post to the course discussions selects an existing topic to associate their post with. For more information about topics, see Basic Elements: Topics, Posts, Responses, and Comments.

You can browse discussions by topic, to join the discussion on subjects that interest you, or to see if anyone else in the course has asked the same question.

View Topics on the Discussion Page

On the Discussion page, you can view both course-wide and content-specific discussions. Select All Topics above the discussion navigation pane to see all of the discussion topics in the course. To see all of the posts in an individual topic, select the topic name in the discussion navigation pane.

Note that course-wide topics do not have other topics indented below them, while content-specific topics are indented under a category name.

Discussion topic list expanded, showing all course discussion topics.
View Topics in a Course Unit

Content-specific topics are located in specific units in the course. They typically appear below the content they apply to.

You can access a content-specific topic by viewing the unit that contains the topic. To show the list of posts for that content-specific discussion, select Show Discussion.

A discussion topic that appears below text inside the course. The "Show Discussion" button opens the list of posts for that content-specific topic.

You can also use the Discussion page to access a discussion in the unit where that topic is located.

  1. In the list of topics, select the topic that you want.
  2. Select a post title to open the complete post and its responses and comments next to the above the discussion navigation pane.
  3. In the text of a post, select the name of the discussion topic to go to the discussion inside the unit.

View Only Unread or Unanswered Posts

To limit the posts shown on the Discussion page or shown for a content- specific discussion, you can select one of the filter options. By default, the Show all option is selected.

  • To show posts (both discussions and questions) that you have not yet viewed, select Unread.
  • To show only question posts that do not yet have any responses marked as answers, select Unanswered.

View Pinned Posts

Pinned posts appear at the top of the list of posts in the discussion navigation pane when you view all discussions. Pinned posts can contain important information about the course or any part of the course, such as a particular video or problem. The pinned post can originate from anyone in the course, including other learners or members of the discussion moderation team, but only members of the moderation team can pin a post.

View Followed Posts

In the discussion navigation pane select Posts I’m Following. The navigation pane refreshes to show only posts that you are following.

View Contributions from a Specific Participant

You can review all the posts, responses, and comments that any learner in the course or member of the course team has made. To do this, select the username that appears at the top of any one of the participant’s contributions. You can also enter a username in the Search all posts field and select the linked username in the search result.

Taking Part in Course Discussions

This topic describes how to add, edit, and delete contributions to discussions.

Note

You might want to enter mathematical or scientific expressions in a discussion. For information about how to enter plain text so that it will appear as a formatted mathematical expression, see Math Formatting in Course Discussions.

Adding a Post

When you add a post to a discussion in your course, you decide what type of post to make and the topic of the post. For course-wide discussion topics, you can add a post on the Discussion page. For content-specific discussions in a course unit, you can add a post either on the Discussion page or directly in the course unit.

Determining the Post Type: Discussion or Question

To make sure that other learners and the course team can find and respond to your post, decide what type of post you want to make: either question or discussion.

  • A question post raises an issue so that the discussion moderation team or community can provide answers.
  • A discussion post starts a conversation by sharing thoughts and reflections, and inviting community participation.

If you have any difficulty deciding which type of post you want to add, think about whether you want to get concrete information (a question) or start an open-ended conversation (a discussion). If you are asking a question about the course and need an answer from the course team, be sure to create your post as a question, so that the course team sees that a response is required and responds appropriately.

After you make your post, on the Discussion page for your course, a question mark image identifies posts that ask questions and a conversation bubble image identifies posts that start discussions.

Note

You can change the post type from discussion to question or vice versa at any time after you add your post. For more information, see Edit or Delete a Post, Response, or Comment.

Determining the Post Topic

Every post in the course discussions has an associated topic. The course team creates the list of discussion topics for each course, and you choose a topic from that list when you create your post. Before you add a post, you should look through the list of topics in the course discussions so that you can decide which topic is the most appropriate for your post. For more information, see Exploring Discussion Posts.

After you decide on a post type and topic, you can add your post on the Discussion page or in the body of the course.

Add a Post on the Discussion Page

You can add a post for course-wide or content-specific discussion topics on the Discussion page.

  1. On the Discussion page, select Add a Post.

  2. Determine the type of post you want to make, and select Question or Discussion.

  3. Determine the most appropriate topic for adding your post to, and select the topic from the Topic Area list.

  4. In the Title box, enter a short, descriptive title. The title is the part of your post that others see when they are browsing on the Discussion page or scrolling through one of the content-specific topics.

  5. Enter the text of your post. To format the text or to add links or images, use the formatting options above the text box.

    Any text formatting or images that you add are only visible when others read your post in a web browser. The edX mobile app currently does not display added formatting or images.

    Note

    If you include an image with your post, include a description so that learners who use screen readers to access the course can understand the image’s content and purpose. The description also displays in place of the image if problems occur with the image file. If the image has no functional purpose, leave the Description field empty and select This image is for decorative purposes only and does not require a description.

    The maximum size for an uploaded file is 1 MB.

In some courses, you can add posts, responses, and comments anonymously. If this is the case, a Post Anonymously option is available under the field where you enter your text. When you post anonymously, the discussion moderation team can see your username, but other learners cannot.

Add a Post in a Course Unit

If you come to a discussion as you work through the units in your course, or if you know where in the course a particular discussion originates, you can add a post for that discussion from the unit in your course.

The following steps apply only to content-specific discussions.

  1. Select Course.

  2. Open the unit in the course that includes the discussion topic that you want to add a post to.

  3. Select Show Discussion to read what others have already contributed to the conversation.

    The title and the first line of each post is shown in the list of posts.

    To read an entire post and view its responses and comments, select any part of the post preview.

  4. To contribute a new post to the discussion, select Add a Post and follow the steps that you use to add a post to the discussion page. For more information, see Add a Post on the Discussion Page.

    To respond to an existing post or comment on an existing response, follow the steps described in Add a Response or Comment.

Note

In some courses, you can add posts, responses, and comments anonymously. If this is the case, a Post Anonymously option is available under the field where you enter your text. When you post anonymously, the discussion moderation team can see your username, but other learners cannot.

Add a Response or Comment

To participate in an ongoing discussion, you reply to the initial post by adding a response, or expand on a particular response by adding a comment.

The same options for formatting the text and for adding links or images are available for responses and comments as for posts.

Add a Response or Comment on the Discussion Page

You can add a response or comment to course-wide or content-specific discussion topics on the Discussion page.

  1. On the Discussion page, find the post that you want to contribute to. To help you decide where to add your thoughts, review the current responses and their comments.

    For more information about finding posts by searching, sorting, or using filters, see Exploring Discussion Posts.

  2. Add a response or comment.

  • To add a response to the post, select Add A Response. When you have finished entering your response, select Submit.
  • To add a comment to a response, move your cursor inside the Add a comment field below the response. When you have finished entering your comment, select Submit.

Add a Response or Comment in a Course Unit

You can add a response or comment to a content-specific discussion topic inside the course.

  1. In the unit that contains the discussion topic where you want to make your contribution, select Show Discussion.
  2. Select the post that you want to contribute to. To help you decide where to add your thoughts, review the current responses and their comments.
  3. Add a response or comment.
  • To add a response to the post, select Add A Response. When your response is complete, select Submit.
  • To add a comment to a response, select inside the Add a comment field below the response. When your comment is complete, select Submit.

Edit or Delete a Post, Response, or Comment

You can only edit or delete your own posts, responses, or comments. You cannot edit or delete contributions from other learners.

  1. Locate the contribution that you want to edit or delete, either in the body of the course or on the Discussion page.

  2. In the upper corner of the contribution, select the “More” icon (...). A menu opens.

    Response with the "More" menu expanded, showing Edit, Delete, and Report options.
  3. Edit or delete the contribution.

  • To edit the contribution, select Edit, make the changes that you want in the text editor that opens, and then select Update Response. For posts, you can change the post topic and the post type as well as the text of the post.
  • To delete the contribution, select Delete, and then select OK in the confirmation box.

Keeping Up with New Activity

This topic describes how to keep up with discussion activity in your edX course.

Reading New or Updated Posts

The list of posts in the discussion navigation pane on the Discussion page provides visual cues to help you distinguish posts that are new, or that have responses or comments that you have not read yet, from exchanges that you have already read completely. For information about the labels and icons used in posts, see Discussion Navigation Pane.

Sorting by Activity

In the discussion navigation pane you can sort posts by activity. To do this, select the drop-down list of sorting options at the top of the discussion navigation pane and select either by recent activity or by most activity.

Sorting by recent activity changes the order of the posts so that the post that was most recently updated appears at the top of the list. Updating includes having responses or comments added.

Sorting by most activity changes the order of the posts so that posts with the most responses or comments appear at the top of the list.

Sorting by Votes

In the discussion navigation pane you can sort posts by the number of votes received. To do this, select the drop-down list of sorting options at the top of the discussion navigation pane, and select by most votes.

Sorting by the most votes changes the order of the posts so that posts that have received the most votes appear at the top of the list. In this view, instead of the response and comments count indicator, the number of votes that each post has received is shown. Votes for responses are not included in the number.

For more information about voting for posts, see Vote for Posts or Responses.

Receiving Daily Digests

You have the option to receive an email message each day that summarizes discussion activity for the posts you are following. To receive this daily digest, select Discussion to go to the discussions home page, and then select the Receive updates check box in the How to use edX discussions graphic.

Discussion how to graphic with the Receive Updates check box circled

Providing Feedback on Contributions

As you read the contributions that other learners and course team members make to discussion topics, you can provide feedback in other ways than writing a complete response or comment.

Feedback Options

When you open a post, response, or comment, the Vote and Follow feedback option icons appear at the top right. Move your cursor over these icons to show the full label.

The "Vote", "Follow", and "More" feedback icons in a post, response, or comment.

Select the “More” icon to show a menu of additional options. Options vary depending on whether the contribution is a post, response, or comment, and on whether you are a learner in the course, or a member of the discussion moderation team.

Vote for Posts or Responses

To provide positive feedback for a post or one of its responses, you can vote for it. Open the post or response, and select the plus sign (+) icon next to the number of Votes. You can only vote for posts added by other discussion participants. You cannot vote for your own posts.

In the discussion navigation pane, you can sort the list of posts so that the posts with the most votes appear at the top. To do this, select the drop-down list of sorting options and select by most votes. For more information about ways to sort the list of discussion topics, see Reading New or Updated Posts.

Follow Posts

If you find a conversation or question particularly interesting, you can follow it so that you can return to it easily.

To follow a post, move your cursor over the star icon for the post, and then select Follow.

Each post that you follow appears with a “Following” indicator in the list of posts.

In the discussion navigation pane, you can list only the posts that you are following, regardless of the discussion topic they apply to. To do this, select All Topics and then select Posts I’m Following.

Answer Questions and Mark Questions as Answered

Anyone in a course can answer questions that are posted in the course discussions. To respond to a question that has been asked by someone else in the course, add a response with your answer to the question post.

If you have received a helpful or correct response to a question that you yourself have asked, you can mark the response as the correct answer. To do this, move your cursor over the check mark icon for the response, and then select Mark as Answer.

Note

The discussion moderation team can mark any response as correct. Learners can only mark responses as correct for their own posts.

After at least one response to a question post is marked as a correct answer, a check mark icon replaces the post’s question mark indicator in the discussion navigation pane.

Report Discussion Misuse

On rare occasions you might come across a discussion contribution that is inappropriate. You can flag any post, response, or comment for a discussion moderator to review. To do so, open the contribution, select More, and then select Report.

The discussion moderation team can investigate any flagged posts, responses, or comments and take the appropriate action.

Note

Only the person who flagged a contribution and the discussion moderation team can see that a contribution has been reported.

Completing Different Types of Assignments

Entering Mathematical and Scientific Expressions

This topic describes how to enter mathematical and scientific expressions for problems in your edX course.

Overview of Mathematical and Scientific Expressions

You might want to enter a mathematical or scientific expression into an assignment in the body of your course, into the edX calculator tool, or into a course discussion.

For assignments in the body of the course and for the calculator tool, you enter plain text, and the edX system then converts your text into numbers and symbols that appear below the response field. For more information, see Entering Math Expressions in Assignments or the Calculator.

Image of a numerical input probem rendered by the parser. Image of a numerical input probem rendered by the parser. Image of a numerical input probem rendered by the parser. Image of a numerical input probem rendered by the parser.

For course discussions, you use MathJax to format the text that you type, and the system then converts your text into a mathematical expression. For more information, see Entering Math Expressions in Course Discussions.

Entering Math Expressions in Assignments or the Calculator

note::

If your course offers the calculator tool, the calculator appears as a small icon on all pages in the body of the course.

Course page with an arrow pointing to the calculator.

To use the calculator, select the calculator icon. To close the calculator, select the X that appears when the calculator is open.

Both the calculator and the response fields in math problems accept a selection of characters that represent numbers, operators, constants, functions, and other mathematical concepts. You might recognize parts of this system if you have used math programs before.

Note

The calculator includes an information page that shows an abbreviated version of the information in this topic. To see the information page, select the circled i icon next to the input field.

Course page with the calculator visible and showing the information page.

When you enter your plain text into the calculator or the response field, follow these guidelines.

  • Arithmetical operations: Use standard characters for addition (+), subtraction (-), multiplication (*), and division (/).
    • Multiplication: Be sure to indicate multiplication explicitly. That is, instead of mc^2 type m*c^2, and instead of 5a+4b+3c type 5*a+4*b+3*c.
  • Operation order: Use parentheses (( )) to specify the order of operations and to make your expression as clear as possible. Use curved parentheses (( )) only. Do not use brackets ([ ]) or braces ({ }).
  • Exponents or superscripts: Insert a caret (^) before an exponent or superscript. If the exponent or superscript includes multiple characters or is an expression, surround the expression with parentheses. For example, you can enter x^n or x^(n-1).
  • Subscripts: Insert an underscore (_) before a subscript to indicate a subscript. If the subscript has multiple characters, type the characters without a space. For example, you can enter v_IN-v_OUT. Note, however, that subscripts cannot currently include operators or parentheses.
  • Avoid whitespace.
  • Do not use equal signs (=).
  • Because the system is case-sensitive, make sure you use uppercase and lowercase letters carefully.

For more information about the types of characters you can use, see below.

Note

The edX system accepts both constants and metric affixes. Be careful to distinguish between constants and metric affixes. Constants stand alone, while metric affixes must be combined with numbers.

For example, c can be a constant representing the speed of light or a metric affix meaning “centi”. When you use c as a metric affix, do not include a space between c and the number. When you use c as a constant, indicate multiplication explicitly. The following examples show the difference:

  • 2c = 0.02 (2 multiplied by 0.01)
  • 2*c = 599584916.0 (the speed of light multiplied by 2)
  • 2M = 2,000,000 (2 multiplied by 1,000,000)
  • 2*M = 2 multiplied by the variable M

For more information, see Scientific Notation and Metric Affixes or Constants.

Numbers

You can use the following types of numbers.

  • Integers: 2520
  • Fractions: 2/3
  • Normal floats: 3.14
  • Floats with no integer part: .98

The largest number you can use is 1.7977e+308, which is the largest float possible in the Python programming language.

Scientific Notation and Metric Affixes

You can enter metric affixes or scientific notation to indicate very large or very small numbers. For scientific notation, you can type either a caret (^) or the letter e followed by a number to indicate an exponent. You can use both positive and negative exponents.

For example, to indicate 0.012, you can enter either of the following expressions:

  • 1.2*10^-2
  • 1.2e-2

To indicate -440,000, you can enter either of the following expressions:

  • -4.4*10^5
  • -4.4e5

The following table shows how to enter numbers with metric affixes, with scientific notation, and with e notation.

To enter this number Use this metric affix Use this scientific notation Use this e notation Other notation
0.1 1d (deci) 10^-1 1e-1  
0.01 1c (centi) 10^-2 1e-2 1% (percent)
0.001 1m (milli) 10^-3 1e-3  
0.000001 1u (micro) 10^-6 1e-6  
0.000000001 1n (nano) 10^-9 1e-9  
0.000000000001 1p (pico) 10^-12 1e-12  
1000 1k (kilo) 10^3 1e3  
1,000,000 1M (mega) 10^6 1e6  
1,000,000,000 1G (giga) 10^9 1e9  
1,000,000,000,000 1T (tera) 10^12 1e12  

Note

When you use metric affixes or e notation, make sure you do not include spaces between the number and the metric affix or the e.

Constants

You can use several different constants in your mathematical expressions.

Note

When you enter constants multiplied by a number, make sure to indicate the multiplication explicitly. For example, enter 2*c instead of 2c and -4*i instead of -4i.

Constant Value
c The speed of light in m/s (2.998^8)
e Euler’s number (2.718...)
g Gravity (9.80 m/s^2)
i The square root of -1
j The square root of -1
k The Boltzmann constant (~1.38^-23 in Joules/Kelvin)
pi The ratio of a circle’s circumference to its diameter (3.14159...)
q The fundamental charge (~1.602^-19 Coloumbs)
T The positive difference between 0K and 0°C (273.15)
Greek Letters

To use any of the following Greek letters, type the name of the letter in the calculator or the response field.

Name Letter
alpha α
beta β
gamma γ
delta δ
epsilon ϵ
varepsilon ε
zeta ζ
eta η
theta θ
vartheta ϑ
iota ι
kappa ϰ
lambda λ
mu μ
nu ν
xi ξ
pi π
rho ρ
sigma σ
tau τ
upsilon υ
phi ϕ
varphi φ
chi χ
psi ψ
omega ω
Functions

To use a function, type the letters that represent the function, and then surround the expression in that function with parentheses. For example, to represent the square root of 4*a+b, type sqrt(4*a+b).

You can use the following functions.

  • Common functions

    • sqrt
    • log10
    • log2
    • ln
    • exp
    • abs
  • Trigonometric functions and their inverses, as well as hyperbolic trigonometric functions and their inverses.

    Function Inverse Hyperbolic Function Inverse
    sin arcsin sinh arcsinh
    cos arccos cosh arccosh
    tan arctan tanh arctanh
    sec arcsec sech arcsech
    csc arccsc csch arccsch
    cot arccot coth arccoth
  • Factorials: Enter factorials as fact(3) or factorial(3). You must use integers. For example, you cannot enter fact(1.5).

  • A “parallel resistors” operator (||). For example, 1 || 2 represents the resistance of a pair of parallel resistors (of resistance 1 and 2 ohms), evaluating to 2/3 (ohms).

Entering Math Expressions in Course Discussions

Entering math expressions in course discussions is different from entering math expressions in a math problem or in the calculator. In course discussions, you use MathJax to format the text that you type.

For detailed information about how to enter math expressions in course discussions, see Math Formatting in Course Discussions.

Taking a Timed Exam

This section describes timed exams and explains how to complete them.

Timed Exam Overview

Timed exams are sets of problems that you must complete in a limited amount of time. The score you receive becomes part of your course progress record.

Timed exams are indicated in the course navigation pane by a clock icon and the label Timed Exam.

Course navigation in the LMS showing an exam with a clock icon and the label "Timed Exam."

After you begin taking a timed exam, a timer on the course page displays the amount of time that you have remaining to complete the exam. You cannot pause or reset a timed exam. When there is no time remaining, the course page automatically submits your exam.

The time limit for an exam applies to all of the units in an exam section. If an exam includes problems on multiple unit pages, you must complete the problems on each unit page before you submit the exam or before the time runs out.

You can request additional time to complete a timed exam. Course teams can increase the time allowed for individual learners if needed. You can only request additional time before you start a timed exam. For more information, see Requesting Additional Time.

Taking a Timed Exam

To take a timed exam, follow these steps.

  1. Open the timed exam page in the course.

  2. Find the length of the time limit on the exam page. Make sure that you have enough time available to complete the exam.

    Note

    You will not be able to pause or restart the exam after you begin.

    Course teams can allow individual learners to take additional time, if needed. For more information, see Requesting Additional Time.

  3. Select I am ready to start this timed exam.

  4. Complete the problems in each unit of the exam. Select Submit to score the problems in the unit. If you do not select Submit, your responses will not be scored.

  5. Monitor the amount of time remaining in the time display at the top of the course page.

    When 20% of the time remains, the time display bar darkens to alert you. When 5% of the time remains, the text on the time display bar becomes bold.

  6. After you have completed and checked all the units in the exam, select End My Exam at the top of the course page. If you run out of time, the exam will end automatically.

Note

You must select Submit to score the problems in each unit of an exam. If you submit an exam without selecting Submit in a unit, your exam results will not include scores for any of the problems in that unit.

Requesting Additional Time

You can request additional time to complete a timed exam. Course teams and instructors can increase the time allowed for individual learners to accommodate specific needs.

You can only request additional time before you begin a timed exam. After you start an exam, the course team cannot allow more time for that exam attempt.

Course teams decide whether or not to grant additional time based on the criteria that they choose. You can get information about the availability of additional time from your course team.

Explaining Multiple Choice Answers

If you encounter a multiple choice question that is followed by a field for an explanation, there are actually several more steps that you need to complete for the assignment. These assignments involve sharing what you have learned with other people in your online course. They give you an opportunity to learn from each other.

In a classroom setting, this type of assignment is sometimes called a “peer instruction” or “clicker” question.

This section describes how you complete these interactive assignments.

Assignment Overview

When a multiple choice question also requires an explanation, the next step in the assignment is to share your rationale for your answer with other learners, and to see the choices and explanation that other learners shared.

Names are not shown with the responses. As a result, you can focus on contributing the best answer possible, without worrying about whether your reasoning, or your spelling, is exactly correct.

Then, you get to apply what you learned from the others: you have another chance to answer the question.

Completing the Assignment

In this type of assignment, you see a multiple choice question. After you select an answer you complete these steps.

Step 1. Explain Your Choice

Write an explanation for why you chose your answer.

This step is your opportunity to provide a persuasive argument about why your answer is the correct one. You might include references to a course video or textbook, or describe how you arrived at the choice you made.

Together, the answer that you chose and this explanation are your initial response. When you select Next, your initial response is added to the collection of initial responses by all of the other course participants.

A question with a selected answer choice and a short description for that choice.
Step 2. Review Other Initial Responses

Review the initial responses that other participants in the course submitted. The course team decides how many you see. You might see one response for each of the possible answer choices, or a set that is chosen completely at random.

This step gives you a chance to learn from the explanations that other learners submitted, and reassess your own understanding of the topic.

Because they are part of the collection of initial responses, your answer and explanation are likely to be shown to other learners when they get to this part of the assignment.

The answers and explanations submitted by three other learners.
Step 3. Revise Your Response

Decide whether you want to change your initial response by selecting a different answer choice, revising your explanation, or both.

This step is optional. You can submit a final response that is the same as your initial response, or change it completely. When you select Next Step, you learn the correct answer.

The same answer choice with an edited explanation.
Step 4. Review the Correct Answer

Review the correct answer choice and the explanation provided by the course team.

The correct answer choice and its explanation.
Step 5. Compare Answers

Use the graphs to compare the percentage of your fellow learners who selected each answer. The first graph shows the percentage of learners who selected each answer initially, and the second graph shows the percentage of learners who selected each answer after they had the opportunity to review the explantions that other learners provided. Compare your own choices, and the correct one, to your peers’.

This step might be just as thought provoking as the other steps.

Histograms of percentage of learners that selected each answer choice for their initial response and their final response.

Note

The graphs appear after 10 learners submit their final responses. If the graphs do not appear, give the others taking the course some time, and then refresh your browser page.

Writing Essays

Some courses include assignments that require written responses to questions that might not have simple or definitive answers. To score one of these essay style assignments, you might be asked to do one or more of the following.

  • Assess your own work.
  • Assess the essays written by other learners.

To receive your score for an essay style assignment, you might receive one or more of the following.

  • Assessments from other learners in the course.
  • An assessment from a member of the course team.

Because these essay assignments have a flexible design and can include different assessment options, they are called open response assessments.

This topic describes how to work with open response assessments in your edX course.

Overview of Open Response Assessments

In an open response assessment, you provide written responses to questions that might not have simple or definitive answers. For some open response assessments, you can submit an image or other file to accompany a written response.

The Steps in an Open Response Assessment

In addition to your own responses to the questions in the assignment, open response assessments have several steps that can include assessment training steps, peer assessments, self assessment, and staff assessments.

  • In training steps, you perform assessments of sample responses that the course team provides. The goal is to give the sample response the same grade that a member of the course team would have given. For more information, see Learn to Assess Responses.

  • In peer assessments, you perform assessments of responses that other learners in the course have submitted, and other learners in the course also assess your responses. For each assignment, your course team decides the number of peer assessments that you have to perform. For more information, see Assess Peer Responses.

  • In self assessments, you assess your own response. For more information, see Assess Your Response.

  • In staff assessments, members of the course team assess your response. For more information, see Staff Grade.

    Note

    Course staff can grade your open response assignment even if a staff assessment step is not included in the assignment. This might happen if, for example, you receive peer assessments of your response that are inappropriate. In such cases, course staff can perform an assessment of your response that overrides any peer assessment grades.

The Rubric, Criteria, and Options

Every open response assessment has a rubric that the course team provides, to be used as guidance for grading. The rubric is a list of expectations that the response should meet. Grading for all the types of assessments in an open response assessment is done by comparing each response against the same rubric.

Rubrics consist of criteria and options.

  • Criteria describe characteristics that each response should have, such as concepts that a response should cover, or the amount of supporting information that a response must include.
  • Each criterion has options, which describe how well each response satisfies the criterion. These are usually a range of ratings, for example “Fair”, “Good”, or “Excellent”.

The following image shows a rubric with two criteria. Each of the criteria has several options.

Rubric showing criteria and options.

When you assess a response, you select the option that best describes how well the response met each of the criteria.

Some open response assessments provide a Top Responses section that shows the top scoring responses for the assignment and the scores that these responses received. If it is provided, this section appears below your score after you complete each step of the assignment.

Completing an Open Response Assessment

When you come to an open response assessment in the course, you see the questions you must answer, with a response field for each question in the assignment. After you enter and submit your response, you assess some of your peers’ responses, your own response, or both, depending on the assignment. Below the final response field in the Your Response step, you can see the steps that your assignment includes.

Open response assessment example with question, response field, and assessment types and status labeled.

The following topics describe how you complete an open response assessment that includes a learner training step, a peer assessment step, a self assessment step, and a staff grade step.

At any time during an assessment, you can see your progress at the bottom of the page under Your Grade. A message indicates the steps that must still be completed before you can receive your final grade for the assignment. For example, you might see the following message.

Not Completed

You have not completed the peer assessment step and self assessment step of
this problem.

Submit Your Response

To submit your response, follow these steps.

  1. Read each question carefully. Some course teams include important information in the question, such as how long a response must be, or specific topics that your response must cover.

    Note

    The total word count for the assessment cannot be more than 10,000 words (approximately the equivalent of 20 pages of 8.5x11 inch paper, with text single-spaced).

  2. For each question, enter your response into the field under Your Response.

  3. When you have completed all of the questions, select Submit your response and move to the next step.

    If you need more time, you can select Save Your Progress to save a draft of your responses, and then come back and submit them later.

After you submit your responses, the next step, which is usually either assessment training or peer assessment, starts immediately. However, you do not have to start the next step right away. If you want to stop working and come back later, just refresh or reopen your browser when you come back.

Note

You can view your own responses at any time after you submit them. To do this, for the response you want to view, select the Your Response heading to expand the response field. Your response appears, along with the status of your response, and information about additional steps you have to complete before you receive your grade.

Image of the Response field collapsed and then expanded.
Submit a File with Your Response

For some assignments, you might be asked to submit a file along with your text response. Those assignments include Choose File and Upload your file options below the response field. Note the following requirements.

  • A text response is always required. If you upload a file in your response, also include a text response that describes the file you have uploaded in such a way that a reviewer who cannot access the uploaded file can still assess the text content of your response using a screen reader or other text parsing tool.
  • You can upload only one file to submit with your response.
  • The file that you upload must be smaller than 5 MB in size.
  • Image files can be in .jpg, .gif, or .png format.

To upload your file, follow these steps.

  1. Below the response field, select Choose File.
  2. Select the file that you want to upload, and then select Open.
  3. Select Upload your file.

The name of the file that you selected and uploaded appears below the response field.

You can replace the file that you uploaded with a different one until you submit your response. To do so, follow steps 1-3 again.

Example response with an image of Paris.

Learn to Assess Responses

As part of an open response assessment, you learn how to assess responses effectively by reviewing and assessing sample responses provided by the course team. You then try to give the sample responses the same scores that the course team selected.

Note

Not all course teams provide sample responses for training. If the course team did not provide sample responses, this step is not included in the assignment.

After you submit your own response, a sample response appears along with the rubric for the assignment. Read the sample response and the rubric carefully, select the options that you think best reflect the response, and then select Compare your selections with the instructor’s selections.

  • If all of your selections are the same as the defined selections, the next sample response opens automatically.
  • If any option that you select is not the same as the defined selection, you see the response again, and the following message appears above the response.
Learning to Assess Responses

Your assessment differs from the instructor's
assessment of this response. Review the response and consider why the
instructor may have assessed it differently. Then, try the assessment again.

For each of the criteria, you see one of the following two messages, depending on whether your selections matched those defined by the course team.

Selected Options Agree
The option you selected is the option that the instructor selected.
Selected Options Differ
The option you selected is not the option that the instructor selected.

In the following example, the learner chose one correct option and one incorrect option.

Sample training response, with one correct and one incorrect option.

You continue to assess the sample response until the options you select for all criteria match the options defined by the course team.

When you have successfully assessed all of the sample responses, you move to the next step in the assignment.

Assess Peer Responses

When the peer assessment step starts, you can see counts of how many responses you are expected to assess and how many you have already assessed at the top of the page. Then you see each original question, another learner’s response, and the rubric for the assignment.

An in-progress peer assessment.

You assess other learners’ responses by selecting options in the rubric. This process will be familiar to you if your assignment included the learn to assess responses step. Additionally, this step has a field below the rubric where you can provide comments about the learner’s response.

Note

Some assessments might have a Comments field for one or more of the assessment’s individual criteria. You can enter up to 300 characters in these fields. In the following image, both criteria have a Comments field. There is also a field for overall comments on the response.

Rubric with comment fields under each criterion and under overall response.

After you have selected options in the rubric and provided additional comments about the response, select Submit your assessment and move to response #{number}.

When you submit your assessment of the first learner’s response, a response from another learner opens for you. Assess each response in the same way that you assessed the first learner’s responses, and submit each assessment. You repeat these steps until you have assessed the required number of responses. The count of how many responses you have assessed updates after you assess each response.

If there are no new submitted responses available for grading, a status message indicates that no peer responses are currently available for you to assess, and that you should check back later.

Assess Additional Peer Responses (optional)

If you have assessed the required number of peer responses, the peer assessment step “collapses” so that only the Assess Peers heading is visible.

The peer assessment step with just the heading visible.

If you want to, you can assess more peer responses than the assignment requires. To assess more responses, select the Assess Peers heading to expand the step, and then select Continue Assessing Peers.

The peer assessment step expanded so that "Continue Assessing Peers" is visible.

Assess Your Response

When you have completed the required number of peer assessments, your self assessment opens. You see your response along with the same rubric that you used in the peer assessment step. Assess your response, and then select Submit Your Assessment.

Staff Grade

In some assignments, a staff assessment step is included for a member of the course team to grade your responses. You do not need to take any action for this step. The status of the Staff Grade step changes to Complete when a member of the course team has completed grading your response.

If a Staff Grade step exists in your assignment, you receive your final assignment grade when staff grading is complete, even if your response has not been assessed by the required number of peer reviewers.

Note

Course staff can grade your open response assignment even if a staff assessment step is not included in the assignment. This might happen if for example you receive peer assessments of your response that are inappropriate. In such cases, course staff can perform an assessment of your response that overrides any peer assessment grades. If a member of the course staff has graded your response, a Staff Grade section appears in the grading details for your assignment.

Receive Your Score and Provide Feedback

After you submit your self assessment, if other learners are still assessing your response, you see this message under the Assess Your Response step.

Your Grade: Waiting for Peer Assessment

Your response is still undergoing peer assessment. After your peers have
assessed your response, you will see their feedback and receive your final
grade.

If you see this message, keep checking back periodically until the peer assessments of your work are complete.

When peer assessment is complete, and if the assignment does not include a staff assessment step, you can see the scores you received from all of the peers who scored your work, as well as your self assessment. You can also see any additional comments that your peers have provided.

If you want to, you can provide feedback on the peer scores that you received, under Provide Feedback on Peer Assessments.

A learner's response with peer and self assessment scores.

If the assignment included a staff assessment step, you receive your final grade when a member of the course team has graded your response. If a staff assessment step is included in the assignment, peer assessment grades and comments are included in the assignment grade details, but the staff grade becomes the final grade.

Peer Assessment Scoring

Note

If a staff grade is provided in the assignment, either because a staff assessment step was included or because a member of the course team graded your response to override inappropriate peer assessments, peer assessments are not taken into account in the grading. If a staff grade exists, it is always your final grade.

Peer assessments are scored by criteria. An individual criterion’s score is the median, not the average, of the scores that each peer assessor gave that criterion. For example, if the Ideas criterion in a peer assessment receives 10 from one learner, 9 from a second learner, and 5 from a third learner, the score for that criterion is 9 (the median), not 8 (the average).

Your final score for a peer assessment is the sum of the median scores for each individual criterion.

For example, a response might receive the following scores from peer assessors.

Criterion Name Peer 1 Peer 2 Peer 3 Median
Ideas (out of 10) 10 7 8 8
Content (out of 10) 7 9 8 8
Grammar (out of 5) 4 4 5 4

To calculate the final score, the system adds the median score for each criterion.

Ideas median (8 out of 10) + Content median (8 out of 10) + Grammar median (4 out of 5) = final score (20 out of 25)

Note, again, that your final score is not the median of the scores that each individual peer assessor gave the response.

View Top Responses (optional)

If the course team included a Top Responses section, you can review the highest-scoring responses submitted for each question. This section appears only after you have completed all the steps of the assignment.

Section that shows the text and scores of the top three responses for the assignment.

Canceled Responses

If the course team deems a response that you have submitted to be inappropriate, they can cancel that response and remove it from peer grading. In the open response assessment you see an indicator that your submission was canceled, with the date and time of the cancellation, and a comment by the course team member about the reason.

The course team might allow you to submit a replacement response for the canceled one, or they might not. If they do not allow you to submit a replacement response, your grade is zero for the assignment.

Try an Example Open Response Assessment Problem

If you want to try an example open response assessment problem, check out the edX demonstration course, edX Demo course. In addition to giving you a tour of a typical edX course, the edX Demo course contains information about open response assessments and an example peer assessment.

Using Google Files and Calendars in an edX Course

This topic describes how to work with files and calendars in your edX course.

Overview of Embedded Files and Calendars

Courses can include files, such as documents, spreadsheets, and presentations, and a calendar. Your course team uses Google to create and maintain these files and calendars. They appear in the body of your course just like any other course content.

Note

Google services are not available in some regions and countries. If Google services are not available in your area, you might see an “image unavailable” message in the place of the Google file or calendar. The course team might provide alternative resources if Google services are not available for you.

Google Drive Files

Your course might include the following types of Google Drive files.

  • Google Docs (text documents)
  • Google Drawings (images)
  • Google Forms (forms or surveys)
  • Google Slides (presentations)
  • Google Sheets (spreadsheets)

For example, your course might include a spreadsheet that resembles this one.

A Google spreadsheet in a course.

You can interact with these Google Drive files in your course. For example, you can complete forms, look through the slides in a presentation, and enter different values in a spreadsheet. However, you cannot save changes that you make to the Google Drive file.

Google Calendars

If your course includes a Google calendar, you see that calendar in the body of the course. You can also add it to your own Google calendar.

A Google calendar in a course.

By default, the view that opens in the course calendar is the view that the course team set. You can change the view by selecting the Week, Month, or Agenda tabs in the upper-right corner.

When you view the calendar in your course, the dates and times on the calendar automatically adjust to your local time. Your time zone information appears in the lower-left corner of the screen.

Add the Course Calendar to Your Own Calendar

If you have your own Google calendar, you can add the Google calendar from a course to it. After you add a calendar, you see that calendar whenever you view your personal calendar, even if you are not signed in to your edX account. The course information appears together with your own information.

A course calendar integrated with a personal Google calendar.

To add the course calendar to your own calendar, view the course calendar in the course, and then select the Google Calendar icon in the lower-right corner of the course calendar.

For more information about Google calendars, see the Google Calendar website.

Working on Team Projects and Activities

In some courses, you might be assigned activities or projects that require working in small groups, or teams. Course staff will create topics that you can choose from. You choose a topic that interests you, and join or form a team with other learners who have the same interest to work on the group activity or project together. You can join only one team in your course.

If your course includes teams, your instructor or course staff will provide information about how you should work in teams, guidelines for joining and creating teams, and using discussions within teams.

About Teams and Topics

If your course uses teams, there is a Teams page where you can see the list of topics that the course team has created, and their descriptions.

You can browse the topics to find one that you are interested in working on. Then, view the list of teams that exist within that topic. Teams are always associated with a specific topic.

For each team, you can view the team members, team details, and discussions to help you decide whether you want to join a particular team. If you do not find a team that you want to join, you can create a new team in the topic. For more information, see Browse Topics and Find a Team to Join.

You can belong to only one team at a time. For information about joining and leaving teams, see Join a Team and Leave a Team.

Browse Topics and Find a Team to Join

To browse topics and find a team to join, follow these steps.

  1. In the course, select the Teams page.

  2. Select the Browse tab.

  3. On the Browse page, view the list of available topics.

    You can sort the topics alphabetically by name, or by the team count in each topic.

  1. When you have found a topic you are interested in, select the arrow button to see the teams that exist in that topic.

    The page showing available topics, with the arrow button for one of the topics highlighted.

You can sort by teams that showed the most recent activity, or by teams with the most open slots.

You can also use keywords to search for teams within a topic. For more information, see Search for a Team.

Each team’s name and description are shown, as well as the number of team members, letting you know whether there is space for you to join.

The View button on a team card within a topic.
  1. To get a better sense of a team’s members, discussion, and communications, select View for a team.

    On the Team Details page, you can browse the team’s discussion posts, but you cannot participate unless you are a member of the team.

    Detailed view of team, showing discussions.

Note

You can navigate from the Team Details page back to the list of teams in a topic or back to the list of all topics using the breadcrumb links at the top of the page.

Search for a Team

You can use keywords to search for teams within a topic that match your interests.

To get a list of teams that match your search keywords, follow these steps.

  1. In the course, select the Teams tab.

  2. On the Teams page, select Browse, then select the topic in which you want to find a team.

  3. In the search field, enter one or more keywords, then press Enter or select the search icon.

    Teams within the topic that match your search are displayed.

    To clear the existing search term, select the X in the search field.

The search field on the topic page.

Note

You can only use whole words for searching teams.

Join a Team

When you have found a team you want to join, select Join Team.

Note

If a team is full, or if you already belong to a team, the Join Team button is not available.

The Join Team button on the **Team Details** page.

You are added as a member. Your profile is added to the list of team member profiles, and you can participate in the team’s discussions. The team that you joined appears on your My Team page.

Note

You can only belong to one team at a time. If you belong to a team, but find another team that you want to join, you must leave the first team before you can join a new one. For information about leaving a team, see Leave a Team.

Leave a Team

Note

EdX recommends that you do not change teams after work in a course has started without carefully considering the impacts to your work and that of your fellow learners.

If you must leave a team, make sure you communicate with your fellow team members and let them know why and when you are leaving. This is especially important if you are part of the way through your course, and you and your team have been working together on a project or activity.

To leave a team that you belong to, follow these steps.

  1. On the Team Details page, select Leave Team.
The Leave Team link on the Team Details page.
  1. In the confirmation dialog, select Leave Team.

After you leave a team, you are no longer visible in the team membership profiles list, or in the membership count. Although you can still view the team’s discussions, you can no longer participate in them.

Create a Team

If you do not want to join any of the existing teams in a topic, you can create a new team. When you create a new team in a topic, you are automatically added as a member.

Note

You cannot create a team if you already belong to a team.

To create a team, follow these steps.

  1. On the Teams page in the course, find a topic that you are interested in.
  2. Select the topic’s arrow button to see the teams that exist in that topic.
  3. At the bottom of the list of teams within the topic, select the create a new team in this topic link.
The "create a new team in this topic" link at the bottom of the page showing all teams in a topic.
  1. On the Create New Team page, add a name and description for the team.

    In the description, include details about your proposed project or activity to help other learners to decide whether they want to join your team and work with you.

    Empty form with fields to be completed when a learner creates a new team.
  2. (Optional) Include some optional details for your team. You can specify a language that members would primarily use to communicate with each other, and a country that members would primarily identify with. Keep in mind that if your team details make the team membership seem too selective, other learners might be discouraged from joining.

    Note

    Be careful in entering your team details. After you save the details for your new team, you cannot change them, and you cannot delete your team.

  1. When you have finished adding your team details, click Create.

    Your new team appears in the list of team under your selected topic. You are automatically added as a team member.

Participating in Team Discussions

After you join a team, you can participate in discussions on your team page with other members.

Although you can view discussions in any team, you must belong to a team to add new posts and responses to the team’s discussion.

Team discussions work in the same way as your course discussions. For information about course discussions, see Anatomy of Course Discussions.

If you leave a team, you can view posts that are made, but you can no longer participate in that team’s discussions.

Bookmarking Course Content

To mark course content so that you can come back to it later, you can bookmark any course page, up to a limit of 100 bookmarks for any one course.

The course material that you bookmark is identified in the unit navigation bar on the Course page, or you can see a list of all of your bookmarks on the My Bookmarks page.

For more information, see the following topics.

Add or Remove a Bookmark

You can bookmark any page in the course. To bookmark a page, select Bookmark this page under the name of the page.

A course page showing the Bookmark control.

After you add a bookmark, Bookmark this page changes to Bookmarked, and an indicator appears in the unit navigation bar.

A course page showing "Bookmarked" and a bookmark icon in the unit navigation bar.

To remove a bookmark from a page, select Bookmarked.

After you remove a bookmark, Bookmarked changes back to Bookmark this page , and the indicator disappears from the unit navigation bar.

View Your Bookmarks

As you go through the course, you can see which pages are bookmarked in the unit navigation bar on the Course page. You can also see a list of all of your bookmarks on the My Bookmarks page.

To access the My Bookmarks page, select Bookmarks above the course navigation pane.

A course page that shows the Bookmarks option above the course navigation pane and units with bookmark icons in the unit navigation bar.

The My Bookmarks page lists all of the pages you have bookmarked in the course, with the most recently created ones at the top. This page includes the location of the bookmarked material and the date that you added the bookmark.

The "My Bookmarks" page showing bookmarks.

To go to any bookmarked page, select View for that bookmark.

Taking Notes in an edX Course

This topic describes how to work with notes in your edX course.

Overview of Notes

As you work through an edX course, you may want to highlight a particular passage or make a note about what you have read. In some edX courses, you can highlight passages and make notes right in the course.

Note

You can create notes for most text in the body of the course. However, notes are currently not available for exercises, videos, or PDF textbooks.

When a course includes the notes feature, every page has a Notes page at the top and a pencil icon in the lower right corner.

Page of course content that includes the Notes page at the top, highlighted text with an accompanying note, and the pencil icon in the lower right corner.

Your notes can contain text as well as tags that help you organize and find your notes. You can see individual notes inside the course content, or you can see a list of your notes on the Notes page. For more information, see The Notes Page.

Highlight a Passage or Add a Note

You can use either the mouse or keyboard shortcuts to create, access, and delete notes. For more information about using keyboard shortcuts, see Keyboard Shortcuts for Notes.

To highlight a passage or add a note that includes text and tags, follow these steps.

  1. Select the text that you want to highlight or make the note about. You can select as much text as you want.

  2. When a pencil “edit” icon appears above the selected text, select the icon to open the note editor.

    Paragraph with text selected and the pencil icon above the selected text.
  3. When the note editor opens, enter your note and any tags that you want to add. You can also save the highlight for the passage without entering a note or tag.

  • To highlight a passage without adding a note or tag, select Save or press Enter. When you move your cursor over the highlighted text, the note field contains the words “no comment”.

  • To enter a note, select Comments, and then type the text of your note. Your note can contain as many words as you want.

  • To add one or more tags, select Add some tags here, and then type any tags that you want to add.

    Tags cannot contain spaces. If you want to add a tag that has more than one word, type multiple words as one word with no spaces, or use hyphens (-) or underscores (_) to separate words in the tag.

    Note editor open with a learner's note.
  1. After you finish writing your note and adding tags, select Save or press Enter. The note editor closes, and the text that you selected remains highlighted.

View Notes

You can view your course notes in two places.

  • You can view individual notes on the page where you created the notes. To see your notes, go to the unit that contains your note and move your cursor over or select the highlighted text. When you select the highlighted text, your note remains open until you move outside the highlighted text.
  • You can view a list of the notes you have made in the course on the Notes page. You can also search your notes and tags on this page.

The Notes Page

On the Notes page, you can see a list of the notes you have made in your course. You can also search the text of your notes or the tags that you added to your notes.

Notes page showing a list of notes.

The Notes page lists your notes by the date you created or edited them, with the most recently modified first. The page shows you both the text that you selected and the note that you made. You can also see the following information next to each note.

  • A link to the location in the course that contains the highlighted text and your note. To go to that location, select the link under Noted in.
  • The time and date when you last edited the note.
  • Any tags that you added.

Edit or Delete a Note or Highlight

To edit a note, follow these steps.

  1. In the course body, move your cursor over the highlighted text until your note appears.

  2. When the note appears, select the pencil icon in the upper right corner to open the note editor.

    Note editor with the pencil and paper and X icons visible.
  3. In the note editor, edit your note, and then select Save.

To delete a note or highlight, follow these steps.

  1. Move your cursor over the highlighted text until your note appears.
  2. When the note appears, select the trash icon in the upper right corner to delete the note or highlight.

Show or Hide Notes

By default, you can see all of your notes. You can hide your notes, and show them again, by selecting the pencil icon in the lower right corner. When the pencil icon has a dark gray background, notes are visible. When the pencil icon has a light gray background, notes are hidden.

Two page excerpts side by side, the image on the right showing notes visible, and the image on the left showing notes hidden.

Note

If you hide notes, you cannot make new notes. To make new notes, select the pencil icon to show notes.

Search Notes

To search your notes, follow these steps.

  1. At the top of any course page, select Notes to open the Notes page.
  2. In the upper right corner of the page, type a search term in the Search notes for field. You can search for the text of a note, or you can search for a tag you created.
  3. Select the magnifying glass icon or press Enter.

Keyboard Shortcuts for Notes

You can use keyboard shortcuts to create, edit, and delete your notes.

Note

These keyboard shortcuts are for both PCs and Macintosh computers. However, you can only use these keyboard shortcuts on browsers that support caret browsing.

Before you use the following keyboard shortcuts, you must make sure that notes are visible. To show or hide notes, press Ctrl + Shift + left bracket ([).

Create a Note Using the Keyboard

To create a note using keyboard shortcuts, follow these steps.

  1. Enable caret browsing mode.
  2. Use the arrow keys to move the cursor to the left of the text that you want to highlight.
  3. Hold down Shift + right arrow to select the text.
  4. Press Ctrl + Shift + right bracket (]) to open the note editor. The note editor opens with the cursor in the text field.
  5. In the text field, type your note.
  6. To add tags, press Tab to move to the tag field, and then add your tags.
  7. To save your note, press Tab to move to the Save button, and then press Enter.

To close the note editor without creating a note, press Tab to move to the Cancel button, and then press Enter. You can also press Esc to close the note editor.

Edit or Delete a Note Using the Keyboard

To edit or delete a note, follow these steps.

  1. Press Tab to move focus to the note that you want.
  2. Press Ctrl + spacebar or Ctrl + Enter to open the note editor.
  3. Press Tab to move the cursor to the text field or the tag field, and then make the changes that you want.
  4. Press Tab to move to the Edit, Delete, or Close button, and then press Enter.

To close the note editor without making any changes, press Esc.

Using the Course Wiki

Some courses include a wiki, which provides a public forum for both students and the course team to access, share, and collaboratively edit information about the course. If your course includes a wiki, you access it by selecting the Wiki tab at the top of any page. (If your course does not include a wiki, this tab is not present.)

The instructional team for your course might use the wiki for the following purposes, among others.

  • Sharing answers to course FAQs and collecting new FAQs.
  • Sharing editable course information, such as download and installation instructions for software required for the course.
  • Allowing students to create and share resources, perhaps as part of a collaborative exercise.
  • Sharing errors and corrections for the course.
  • Collecting suggestions for future runs of the course.

As a student, you can perform the following tasks, depending on the permissions that are set for the wiki.

This section describes how you can contribute to the course wiki.

Adding a Wiki Article

When you add an article to the wiki, be aware of what level you are currently viewing, to make sure that you add your new article to the correct level in the course wiki.

To move down a level in the wiki, select See all children; to move up, select the appropriate level in the wiki breadcrumb trail links at the top of the page.

Add Articles at the Same Level

To add a wiki article at your current level, follow these steps. If you do not have permissions to add an article, when you select Add Article, a message indicates “Permission Denied” .

  1. In your course, select Wiki.
  2. Navigate to the level where you want to add a new article.
  3. Select the Add Article button near the top right of the page.
  4. On the new article page, add a title for the page, and optionally a few keywords to create a “slug” that provides a more specific location identifier for your article.
  5. Add contents to the article. You can enter plain text and use Markdown syntax to add formatting. For help with Markdown syntax, select the link to the cheat sheet at the upper right corner of the Contents field.
  6. When you have finished entering content for your wiki article, select Create Article.

Add Articles Below the Current Level

To add a child article to your current article, follow these steps. If you do not have permissions to add an article, when you select Add Article, a message indicates “Permission Denied” .

  1. In your course, select Wiki.
  2. Navigate to the level above where you want to add the new child article.
  3. Select See all children.
  4. Select the Add Article button under the wiki title.
  5. On the new article page, add a title for the page, and optionally a few keywords to create a “slug” that provides a more specific location identifier for your article.
  6. Add contents to the article. You can enter plain text and use Markdown syntax to add formatting. For help with Markdown syntax, select the link to the cheat sheet at the upper right corner of the Contents field.
  7. When you have finished entering content for your wiki article, select Create Article.

Editing a Wiki Article

If you have permissions to edit an article, you see an Edit button and icon to the right of the article content.

To make changes to a wiki article, follow these steps.

  1. In your course, select Wiki.
  2. Navigate to the article you want to edit.
  3. Select Edit.
  4. Make your changes. For help with Markdown syntax, select the link to the cheat sheet at the upper right corner of the Contents field.
  5. In the Summary field at the bottom left, below the Contents field, enter a short description of the changes you made. This description appears in the Changes list, and helps other users of the wiki understand what changes you made to the article.
  6. When you have finished making edits, select Save changes.

Searching for Wiki Articles

A Filter field is available only if any level of the wiki contains multiple articles.

Enter a text string in the Filter field to find a list of all articles with that text string in their titles.

Managing Versions of Wiki Articles

The wiki includes a change history for each article. You can view each past version of the article, roll back to a selected earlier version of the article, or merge the current version of the article with a selected earlier version.

View a List of Previous Versions of a Wiki Article

  1. In your course, select Wiki.
  2. Navigate to the wiki article for which you want to see the change history.
  3. Select Changes. Previously saved versions of the current article are listed, with the most recent at the top.

View a Previous Version of a Wiki Article

  1. On the Changes page for your wiki, select the revision of the article that you want to view.
  2. Select Preview this revision to see the article as it appeared after the revision was made.

See Line by Line Changes in a Previous Version

  1. On the Changes page for your wiki, select the revision of the article that you want to view.
  2. Select the linked date, time, and author information to see the line-by-line changes made in that revision. Text that is highlighted in red has been replaced by the text that is highlighted in green below it.

Replace a Current Version with a Previous Version

  1. On the Changes page for your wiki, select the revision of the article that you want to roll back to.
  2. Select Switch to selected version to replace the current version with the selected one.

Combine a Current Version with a Previous Version

  1. On the Changes page for your wiki, select the revision of the article that you want to merge with the current version.
  2. Select Merge selected with current to combine the current and the selected versions.

The wiki for each course is a “child” wiki of the edX-wide wiki. From within any course wiki, selecting the top level Wiki link in the breadcrumb trail in the upper-left corner of the page takes you to the edX-wide wiki. To get back to your course wiki, select the Wiki tab at the top of the page.

Understanding How Courses and Videos Are Licensed

This topic describes licenses in your course and restrictions on using course content.

Overview of Licenses

The course author can specify licensing options for course content as well as for each video in the course.

The course and video licenses specify whether and how you can reuse course content.

All Rights Reserved

All Rights Reserved indicates that the course author owns the copyright but reserves all rights for sharing copies of course content or videos. You cannot reuse or republish course content or videos that have All Rights Reserved licenses.

Creative Commons License

The Creative Commons license indicates that the course author owns the copyright but is granting certain permissions for reuse, depending on the license options selected by the course team.

A Creative Commons license has one or more of the following options.

License Option Description
Attribution This option allows you to copy, distribute, display, and perform copyrighted work but only if they give credit the way you request. This option is always selected for edX courses and videos under a Creative Commons license.
Noncommercial This option allows you to distribute, display, and perform work–and derivative works based upon it–but for non-commercial purposes only.
No Derivatives This option allows you to distribute, display, and perform only verbatim copies of the work, not derivative works based upon it. This option cannot be in use with the Share Alike option.
Share Alike This option allows you to distribute derivative works only under a license identical to the license that governs the work. This option cannot be in use with the No Derivatives option.

For more information, see the Creative Commons website.

Viewing Licenses

If the course author has set a license for the course, you see the license a the bottom of the page when you view content in the Course tab.

A course unit page with a pointer to the license.

If a video has a different license than the course as a whole, you see the license at the bottom right of the video player.

A video with a pointer to the license.

For a license that reserves some, but not all, rights, you can select the license to get see information about your rights.

General Information

Read Me

The Open edX Learner’s Guide is created using RST files and Sphinx. You, the user community, can help update and revise this documentation project on GitHub.

https://github.com/edx/edx-documentation/tree/master/en_us/open_edx_students/source

The edX documentation team welcomes contributions from Open edX community members. You can find guidelines for how to contribute to edX Documentation in the GitHub edx/edx-documentation repository.

Other edX Resources

Learners, course teams, researchers, developers: the edX community includes groups with a range of reasons for using the platform and objectives to accomplish. To help members of each group learn about what edX offers, reach goals, and solve problems, edX provides a variety of information resources.

To help you find what you need, browse the edX offerings in the following categories.

All members of the edX community are encouraged to make use of the resources described in this preface. We welcome your feedback on these edX information resources. Contact the edX documentation team at docs@edx.org.

Resources for edx.org Learners

Documentation

The EdX Learner’s Guide is available on the docs.edx.org web page. This guide is also available when you select Help while you are in a course, and from your dashboard of enrolled courses.

In a Course

All edX courses have a discussion page where you can ask questions and interact with other students and with the course team: select Discussion. Many courses also offer a wiki for additional resources and materials: select Wiki.

Other resources might also be available, such as a course-specific Facebook page or Twitter feed. Be sure to check the Home page for your course as well as the Discussion and Wiki pages.

Resources on the edx.org Website

To help you get started with the edX learning experience, edX offers a course (of course!). You can find the edX Demo course on the edx.org website.

When you are working in an edX course, you can select Support to access a help center with frequently asked questions and answers.

If you still have questions or suggestions, you can get help from the edX support team: select Support, select Contact at the bottom of any edX web page, or send an email message to info@edx.org.

For opportunities to meet others who are interested in edX courses, check the edX Global Community meetup group.

The edX Partner Portal

The edX Partner Portal is the destination for partners to learn, connect, and collaborate with one another. Partners can explore rich resources and share success stories and best practices while staying up-to-date with important news and updates.

To use the edX Partner Portal, you must register and request verification as an edX partner. If you are an edX partner and have not used the edX Partner Portal, follow these steps.

  1. Visit partners.edx.org, and select Create New Account.
  2. Select Request Partner Access, then fill in your personal details.
  3. Select Create New Account. You will receive a confirmation email with your account access within 24 hours.

After you create an account, you can sign up to receive email updates about edX releases, news from the product team, and other announcements. For more information, see Release Announcements by Email.

Course Team Support in the edX Partner Portal

EdX partner course teams can get technical support in the edX Partner Portal. To access technical support, submit a support ticket, or review any support tickets you have created, go to partners.edx.org and select Course Staff Support at the top of the page. This option is available on every page in the Partner Portal.

The Open edX Portal

The Open edX Portal is the destination for learning about hosting an Open edX instance, extending the edX platform, and contributing to Open edX. In addition, the Open edX Portal provides product announcements and other community resources.

All users can view content on the Open edX Portal without creating an account and logging in.

To comment on blog posts or the edX roadmap, or subscribe to email updates, you must create an account and log in. If you do not have an account, follow these steps.

  1. Visit open.edx.org/user/register.
  2. Fill in your personal details.
  3. Select Create New Account. You are then logged in to the Open edX Portal.
Release Announcements by Email

To receive and share product and release announcements by email, you can subscribe to announcements on one of the edX portal sites.

  1. Create an account on the Open edX Portal or the edX Partner Portal as described above.
  2. Select Community and then Announcements.
  3. Under Subscriptions, select the different types of announcements that you want to receive through email. You might need to scroll down to see these options.
  4. Select Save.

You will now receive email messages when new announcements of the types you selected are posted.

System Status

For system-related notifications from the edX operations team, including outages and the status of error reports. On Twitter, you can follow @edxstatus.

Current system status and the uptime percentages for edX servers, along with the Twitter feed, are published on the edX Status web page.

Resources for edx.org Course Teams

Course teams include faculty, instructional designers, course staff, discussion moderators, and others who contribute to the creation and delivery of courses on edx.org or edX Edge.

The edX Course Creator Series

The courses in the edX Course Creator Series provide foundational knowledge about using the edX platform to deliver educational experiences. These courses are available on edx.org.

edX101: Overview of Creating a Course

The edX101 course is designed to provide a high-level overview of the course creation and delivery process using Studio and the edX LMS. It also highlights the extensive capabilities of the edX platform.

StudioX: Creating a Course with edX Studio

After you complete edX101, StudioX provides more detail about using Studio to create a course, add different types of content, and configure your course to provide an optimal online learning experience.

BlendedX: Blended Learning with edX

In BlendedX you explore ways to blend educational technology with traditional classroom learning to improve educational outcomes.

VideoX: Creating Video for the edX Platform

VideoX presents strategies for creating videos for course content and course marketing. The course provides step-by-step instructions for every stage of video creation, and includes links to exemplary sample videos created by edX partner institutions.

Documentation

Documentation for course teams is available on the docs.edx.org web page.

  • Building and Running an edX Course is a comprehensive guide with concepts and procedures to help you build a course in Studio and then use the Learning Management System (LMS) to run a course.

    You can access this guide by selecting Help in Studio or from the instructor dashboard in the LMS.

  • Using edX Insights describes the metrics, visualizations, and downloadable .csv files that course teams can use to gain information about student background and activity.

  • The edX Release Notes summarize the changes in each new version of deployed software.

These guides open in your web browser. The left side of each page includes a Search docs field and links to the contents of that guide. To open or save a PDF version, select v: latest at the lower right of the page, then select PDF.

Note

If you use the Safari browser, be aware that it does not support the search feature for the HTML versions of the edX guides. This is a known limitation.

Email

To receive and share information by email, course team members can:

  • Subscribe to announcements and other new topics in the edX Partner Portal or the Open edX Portal. For information about how to subscribe, see Release Announcements through the Open edX Portal.
  • Join the openedx-studio Google group to ask questions and participate in discussions with peers at other edX partner organizations and edX staffers.
Wikis and Web Sites

The edX product team maintains public product roadmaps on the Open edX Portal and the edX Partner Portal.

The edX Partner Support site for edX partners hosts discussions that are monitored by edX staff.

Resources for Researchers

At each partner institution, the data czar is the primary point of contact for information about edX data. To set up a data czar for your institution, contact your edX partner manager.

Data for the courses on edx.org and edX Edge is available to the data czars at our partner institutions, and then used by database experts, statisticians, educational investigators, and others for educational research.

Resources are also available for members of the Open edX community who are collecting data about courses running on their sites and conducting research projects.

Documentation

The edX Research Guide is available on the docs.edx.org web page. Although it is written primarily for data czars and researchers at partner institutions, this guide can also be a useful reference for members of the Open edX community.

The edX Research Guide opens in your web browser, with a Search docs field and links to sections and topics on the left side of each page. To open or save a PDF version, select v: latest at the lower right of the page, and then select PDF.

Note

If you use the Safari browser, be aware that it does not support the search feature for the HTML versions of the edX guides. This is a known limitation.

Discussion Forums and Email

Researchers, edX data czars, and members of the global edX data and analytics community can post and discuss questions in our public research forum: the openedx-analytics Google group.

The edX partner portal also offers community forums, including a Research and Analytics topic, for discussions among edX partners.

Important

Please do not post sensitive data to public forums.

Data czars who have questions that involve sensitive data, or that are institution specific, can send them by email to data.support@edx.org with a copy to your edX partner manager.

Wikis

The edX Analytics team maintains the Open edX Analytics wiki, which includes links to periodic release notes and other resources for researchers.

The edx-tools wiki lists publicly shared tools for working with the edX platform, including scripts for data analysis and reporting.

Resources for Developers

Software engineers, system administrators, and translators work on extending and localizing the code for the edX platform.

Documentation

Documentation for developers is available on the docs.edx.org web page.

  • The edX Platform Developer’s Guide includes guidelines for contributing to the Open edX project, options for extending the Open edX platform, instrumenting analytics, and testing.
  • Installing, Configuring, and Running the Open edX Platform provides procedures for getting an edX developer stack (devstack) and production stack (fullstack) operational.
  • Open edX XBlock Tutorial guides developers through the process of creating an XBlock, and explains the concepts and anatomy of XBlocks.
  • Open edX XBlock API Guide provides reference information about the XBlock API.
  • edX Open Learning XML Guide provides guidelines for building edX courses with OLX (open learning XML). Note that this guide is currently an alpha version.
  • edX Data Analytics API provides reference information for using the data analytics API to build applications to view and analyze learner activity in your course.
  • edX Platform APIs provide reference information for building applications to view course information and videos and work with user and enrollment data.

Note

If you use the Safari browser, be aware that it does not support the search feature for the HTML versions of the edX guides. This is a known limitation.

GitHub

These are the main edX repositories on GitHub.

Additional repositories are used for other projects. Our contributor agreement, contributor guidelines and coding conventions, and other resources are available in these repositories.

Getting Help

The Getting Help page in the Open edX Portal lists different ways that you can ask, and get answers to, questions.

Wikis and Web Sites

The Open edX Portal is the entry point for new contributors.

The edX Engineering team maintains an open Confluence wiki, which provides insights into the plans, projects, and questions that the edX Open Source team is working on with the community.

The edx-tools wiki lists publicly shared tools for working with the edX platform, including scripts and helper utilities.

Resources for Open edX

Hosting providers, platform extenders, core contributors, and course staff all use Open edX. EdX provides release-specific documentation, as well as the latest version of all guides, for Open edX users. The following documentation is available.

  • Open edX Release Notes provides information on the contents of Open edX releases.
  • Building and Running an Open edX Course is a comprehensive guide with concepts and procedures to help you build a course in Studio, and then use the Learning Management System (LMS) to run a course.
  • Open edX Learner’s Guide helps students use the Open edX LMS to take courses. This guide is available on the docs.edx.org web page. Because learners are currently only guided to this resource through the course, we encourage course teams to provide learners with links to this guide as needed in course updates or discussions.
  • Installing, Configuring, and Running the Open edX Platform provides information about installing and using devstack and fullstack.
  • The edX Platform Developer’s Guide includes guidelines for contributing to the Open edX project, options for extending the Open edX platform, instrumenting analytics, and testing.
  • Open edX XBlock Tutorial guides developers through the process of creating an XBlock, and explains the concepts and anatomy of XBlocks.
  • Open edX XBlock API Guide provides reference information on the XBlock API.
  • EdX Open Learning XML Guide provides guidelines for building edX courses with Open Learning XML (OLX). Note that this guide is currently an alpha version.
  • EdX Data Analytics API provides reference information for using the data analytics API to build applications to view and analyze learner activity in your course.
  • EdX Platform APIs provide reference information for building applications to view course information and videos and work with user and enrollment data.

Note

If you use the Safari browser, be aware that it does not support the search feature for the HTML versions of the edX guides. This is a known limitation.

edX Browser Support

The edX platform runs on the following browsers.

The edX platform is routinely tested and verified on the current version and the previous version of each of these browsers. We generally encourage the use of, and fully support only, the latest version.

Note

If you use the Safari browser, be aware that it does not support the search feature for the guides on docs.edx.org. This is a known limitation.