How to Direct Links to Units in Open edX Studio?
Create Internal Navigation Links Between Course Units in Open edX
Overview
To add a direct link in Open edX Studio, highlight text in a Text Component, click the Link icon, and enter either an external web address or an internal /jump_to_id/LOCATION_ID path. Direct links help you guide learners to external websites or to specific content elsewhere within your course. Using the internal referencing format ensures your links remain intact even if you export, import, or re-run the course later.
Tip: Ensure you are logged into Open edX Studio before starting.
How Do I Add a Link to an External Website?
Use this method when you want to link a piece of text to an external source, article, or tool.
Procedures:
-
Open the unit and edit the Text Component where you want to add the link.
-
In the visual editor, highlight the text that will serve as the clickable link.
-
Click the Link icon in the editor toolbar.
-
In the Insert/Edit Link dialog box, paste the destination web address into the URL field.
-
Target Option: If you want the link to open in a separate tab so learners do not lose their place in the course, select the dropdown arrow next to Open Link In... and choose New Window.
-
Click OK or Save.
-
Click the Save button on the Text component.
-
Test the link by using the Preview or View Live Version buttons at the top right of the unit editor.
How Do I Add a Link to Another Unit in My Course?
To link to another unit in your course, copy the destination unit's Location ID and enter it in the link URL field using the format /jump_to_id/LOCATION_ID. This keeps the link intact when the course is exported, imported, or re-run, because the identifier does not depend on the course domain or browser URL.
Procedures:
Step 1: Copy the Unit Location ID
-
Navigate to the destination unit (the page you want to send learners to).
-
Look at the right-hand panel of the unit editor under Unit location.
-
Locate the Location ID field.
-
Click the copy icon or highlight and copy the alphanumeric identifier string.

Step 2: Insert the Jump Link
-
Go back to the unit and open the Text Component where the link should live.
-
Highlight the text you want to make clickable.
-
Click the Link icon in the editor toolbar.
-
In the URL field, input the command following this exact format:
/jump_to_id/LOCATION_ID(ReplaceLOCATION_IDwith the actual alphanumeric text you copied in Step 1). -
Example:
/jump_to_id/a1b2c3d4e5f6g7h8i9j0 -
Click Insert or OK.
-
Click the Save button on the Text component to save your changes to the unit.
Make sure the destination unit is published, then test the link by using the Preview or View Live Version buttons at the top right of the unit editor.
Caution: Always use the /jump_to_id/ format with both forward slashes. Do not paste the raw browser URL from your address bar. If you use the browser URL, the link will break completely if the course is exported, imported, or duplicated as a re-run.
Important Rules
-
Publishing Requirement: For an internal link to work correctly for learners in the LMS, the destination unit must be published. If it is in draft form, the link will result in an error for non-staff users.
-
Component Deletion: If you delete a unit or component that is being targeted by a jump link, the link will become broken. You must manually remove or update the link in the source text.
