The next step is to add the draft lesson to Learn.WordPress.org. When you are ready to add the Lesson, log in to Learn.WordPress.org, and navigate to the dashboard. If you don’t have permission to do this, ping the @tt-admins group in the #training channel in Slack.
If you are adding the Lesson to a course, Navigate to Sensei -> Courses.
Click on the course you are adding the Lesson to, to edit the course landing page. Add a thumbnail image as the course’s featured image, following this guide.
Find the correct module, and add your Lesson to the module.
If the module does not exist, use the Sensei Add Module or Lesson button to add the module. Make sure to use the same module title from the GitHub issue.
To add a Lesson, click on the last Lesson in the module list, and then click on the Add Lesson option, which appears below it. If this is a new module, you can click on the Add Lesson option.
Give the Lesson a title, and then click on the Save to edit Lesson button in the block toolbar. Once the Lesson is saved, click on the Edit Lesson button in the block toolbar to edit the newly created Lesson.
If this is a new Lesson, choose the Default Lesson Layout during the Lesson creation wizard.
If you are adding a stand-alone Lesson, navigate to Sensei -> Lessons, and click on the New Lesson button.
In the Lesson creation wizard, give your Lesson a title, and select the Default Lesson Layout
When creating a new Lesson, give your Lesson the title from the GitHub issue and add the Lesson transcript/script below the video.
When adding the text content, make sure to break up the text into logical sections using H2 headers. Also, consider adding screenshots or image hotspots to highlight relevant content from the video.
For each Lesson, also:
- Thumbnails – Upload the thumbnail image you created as the Lesson’s featured image.
- Levels – Select the experience level on individual Lessons so it appears on the Lesson “cards” that appear on the homepage and archives. (Eventually, this might be pulled out of the parent course, but for now this box has to be checked off manually on each lesson that’s part of a course.)
- Featured lessons – Check this box if you’d like to Feature a lesson in one of the six slots on the homepage.
- Excerpt – Write a short manual excerpt for each course and Lesson, maximum 16 words. This will appear on the Lesson “cards” on the homepage and archives. Check to make sure the excerpt is short enough and doesn’t get cut off.
Notice block
If you want to call attention to something within a lesson, use the Notice block, which has a special design to make it stand out.

Keep in mind that the Callout block is deprecated, so it should no longer be used. If you’re updating a lesson and noticed a Callout block, copy it into a Notice block instead.