Content provides a modern, streamlined content workflow without requiring content migration. All content available in Classic Content is also visible in Content, so you can enable it whenever you are ready without migrating your existing content.
Use this guide to decide how to enable Content across your organization.
Choose how to introduce Content
You can introduce Content broadly, or you can trial it first. No migration is required. All Classic Content remains visible in Content.

|
Important: Changing the content experience for a course changes the view for everyone in that course, including learners. |
Before you begin
Enable these settings regardless of which transition option you choose.
To allow any course to use Content across your organization
- Go to Admin Tools > Config Variable Browser.
- Search for d2l.Tools.Content.IsLessonsEnabled (Org).
- Set the Org value to ON, and click Save.

|
Note: This does not change the content experience for existing courses; it only allows Content to be used. |
Verify permissions across Brightspace tools
There are many permissions required to view and evaluate activities from Content. Ensure the following permissions are enabled:
| Tool |
Learner permissions (My Work) |
Facilitator permissions (Completion Summary – view only) |
Evaluator permissions (Completion Summary – view and evaluate) |
|---|
| Assignments |
Assignments > See and Submit Files to Assignment Submission Folders Content > View Course Content |
Assignments > See and Manage Assignment Submission Folders Assignments > View Submitted Files Content > Manage Content |
View permissions Assignments > Give Feedback |
| Quizzes |
Quizzes > View Quizzes Quizzes > Take Quizzes (As Participant) Content > View Course Content |
Quizzes > View Quizzes Quizzes > View Quiz Setup Content > Manage Content |
View permissions Quizzes > Grade Submitted Quizzes |
| Discussions |
Discussions > View Discussions Discussions > Compose New Threads Discussions > Can be assessed (permission setting is selected) Content > View Course Content |
Discussions > View Discussions Discussions > Can be assessed (permission setting is unselected) Content > Manage Content |
View permissions Discussions > Assess Topics |
| External Learning Tools (LTI) |
Not Applicable – Learners can already view LTI topics inline. No change in their view. |
External Learning Tools > Launch External Learning Tool Links Content > Manage Content Content > See Content Stats Content > Create and Edit Modules and Topics |
Not Applicable – LTI topics are not evaluated in Brightspace |

|
Note: For Discussions, permission settings can be edited by navigating to Roles and Permissions, selecting the context menu next to the role name, and then clicking Edit Settings. Role permission changes may take a few minutes to take effect on Content pages. |
Option 1: Let instructors opt in at the course level
To allow selected roles to switch a course between Classic Content and the Content Experience
- Go to Admin Tools > Config Variable Browser.
- Search for d2l.Tools.Content.ChooseContentExperience (Role) and select it.
- Click Add Value.
- From Role, select Instructor (and any additional roles as needed).
- From Value, select ON, then click Save.

|
Note: Keep this setting at the Instructor level or higher. Switching affects the view for all users in the course.
|
Option 2: Pilot with selected org units
To enable the Content Experience only for specific org units
- Click Admin Tools > Config Variable Browser.
- Search for d2l.Tools.Content.UseLessonsExperience (Org Unit) and then select it.
- Click Add Value > Select Org Unit.
- Select the org unit or units that should use the Content Experience.
- From Value, select ON, then click Save.

|
Tip: To efficiently enable Content for all future courses, but leave active courses using Classic Content, set d2l.Tools.Content.UseLessonsExperience to ON at the Organization level, and add any org units that should remain on Classic Content with an OFF override. You can combine this option with Option 1 so instructors outside the pilot can opt in at the course level. |
Option 3: Enable everywhere
To enable Content across the entire organization
- Click Admin Tools > Config Variable Browser.
- Search for d2l.Tools.Content.UseLessonsExperience (Org Unit) and select it.
- Click Add Value > Select Org Unit.
- Search for your Organization (the top of the org unit hierarchy), select it, and select Update.
- From Value, select ON, then click Save.
- Remove any OFF overrides in child org units that would prevent inheritance of ON.
Optional configurations
The following optional configuration variables help you customize the Content experience for your organization. If your organization is switching from Classic Content or the Learner experience, you can use these configuration variables to maintain familiar behaviors and terminology for instructors and learners.
| Configuration variable |
Values |
Description |
|---|
d2l.Tools.Content. DisplayContentOutsideofAvailabilityDates
|
Hidden (default)Access Restricted |
Determines whether learners can view content with future or past availability dates in the Table of Contents. Hidden is the default setting and hides content from learners outside the availability dates. Access Restricted displays the content in the Table of Contents, but learners cannot access it outside the availability dates. Note: Consider using Access Restricted if your organization is switching from Classic Content because Classic Content supports only Access Restricted. |
d2l.Tools.Content. Lessons.NewTopicsAreVisibleByDefault
|
OFF (default)ON |
Determines whether new topics created in Content are visible by default. ON makes new topics visible. OFF hides new topics by default, and instructors must make each new topic visible before learners can see it. Note: Consider using ON if your organization is switching from Classic Content to provide a similar experience. In Classic Content, topics are visible by default, and instructors choose whether to hide them from learners. |
d2l.Tools.Content. EnableImmersiveView
|
OFF (default)ON |
Enables a full-width Table of Contents as the landing page for courses using the Content experience. Selecting a content item opens the reading view with an immersive navigation bar instead of the default Brightspace navigation. The navigation panel width is adjustable to change the amount of space available for course content. If the value is ON, the immersive view is used. Note: Consider using ON if your organization is switching from the Learner experience. This provides learners with a similar experience while ensuring that instructors and learners see the same view. |
d2l.Tools.Content. EnableHTMLTemplates
|
OFF (default)ON |
Determines whether HTML templates are available to use when creating a new content Page from the directory configured in d2l.Tools.Content.TemplatePath. |
d2l.Tools.Content. TemplatePath
|
Empty value (default) Path of a file directory with templates |
Directory containing HTML templates. For example, if templates are uploaded to the Brightspace Public Folder: /shared/HTML-Template-Library/HTML-Templates-V5/pages/. If templates are in individual course locations: /content/enforced/{OrgUnitId}-{OrgUnitCode}/HTML_Templates. |
d2l.Languages. Terminology.ModuleHierarchy
|
Unit/Lesson/Folder (default) Module/Submodule |
Defines the terminology to use for the Content experience course structure. Note: Consider using this configuration variable if your organization is switching from Classic Content to use terminology that is familiar to users. |