Creating a lesson

Once you’ve received confirmation to go ahead with creating your Lesson, you should follow the following steps.

A note on Lesson content.

When preparing or recording your Lesson, please keep the following guidelines in mind.

  • The Lesson should follow the WPTV Submission Guidelines
  • The Lesson should follow the Brand Guidelines for Learn WordPress
  • The Lesson should follow the Promotional Guidelines for Learn WordPress
  • Media assets used must be licensed CC0
    • you can make use of The community site where WordPress code is created and shared by the users. This is where you can download the source code for WordPress core, plugins and themes as well as the central location for community conversations and organization. or Openverse media

What do other content creators do?

Here are two examples illustrating the different approaches taken by two content creators in the Training Team when creating a lesson.

Example 1: Jonathan’s content creation process (opens in a new tab)

Example 2: Wes’s content creation process (opens in a new tab)

Top ↑

The Training Team is here to help

At any point during the Lesson creation process, if you need some guidance or an early review of what you’re working on, feel free to reach out to the Training Team for help.

You can upload any resources you need feedback on to the comments of the GitHubGitHub GitHub is a website that offers online implementation of git repositories that can easily be shared, copied and modified by other developers. Public repositories are free to host, private repositories require a paid subscription. GitHub introduced the concept of the ‘pull request’ where code changes done in branches by contributors can be reviewed and discussed before being merged be the repository owner. issue, and then share the link in the Training Team SlackSlack Slack is a Collaborative Group Chat Platform The WordPress community has its own Slack Channel at channel, and ask for feedback. 

Top ↑

Step 1: Add Lesson creation checklist

If you haven’t already, add the Lesson creation checklist to your Lesson issue in GitHub.

Top ↑

Step 2: Finalize your Lesson title

Finalize your Lesson title based on feedback submitted during the vetting process. Action words like create, use, and explore, help to draw the reader’s attention. 

Top ↑

Step 3: Write script

Start by writing out your Lesson script (or use an existing Lesson plan!) 

This is the part where you gather all of your ideas, and links to existing materials, develop an outline for what you would like to present, and begin to work on any supporting materials, such as slides or screenshots. Your script does not need to be a full blog post, you could just make short notes of what you plan to cover, whatever works best for you.

Top ↑

Step 4: Create graphics

For consistency, use the Figma thumbnail generator to create a professional-looking thumbnail image to be used as the Featured ImageFeatured image A featured image is the main image used on your blog archive page and is pulled when the post or page is shared on social media. The image can be used to display in widget areas on your site or in a summary list of posts. on and as the poster thumbnail on YouTube. To get prepared:

Things to remember:

  • If you opt for a template with text, be sure to use sentence case when adding the title to your title card. Example: Use “An introduction to WordPress” rather than “An Introduction to WordPress.”
  • Do not include a face or instructor name in the title card. If you’ve chosen a template with any faces (avatars), click the Faces component and click the eye icon next to it to hide it, or right-click the component and select the “Show/Hide” option in the menu.
  • Similarly, if you’re using a template with Guest names, select the Speaker component and and click the eye icon next to it to hide it, or right-click the component and select the “Show/Hide” option in the menu.
  • Vary the template and color variation from lesson to lesson so you aren’t using the same ones back-to-back.
  • If you’ve chosen a template that features an image (other than the ones that feature a preselected BlockBlock Block is the abstract term used to describe units of markup that, composed together, form the content or layout of a webpage using the WordPress editor. The idea combines concepts of what in the past may have achieved with shortcodes, custom HTML, and embed discovery into a single consistent API and user experience. Editor image), replace it with an open sourceOpen Source Open Source denotes software for which the original source code is made freely available and may be redistributed and modified. Open Source **must be** delivered via a licensing model, see GPL. image from a source like WordPress Photo Directory, Openverse, or Pexels. Make sure no credit is required in the image’s license terms.
  • Export your thumbnail by following the handbook instructions.

For graphics elsewhere in your lesson:

  • When creating slides and graphics, keep the “coherence principle” in mind: People learn better with fewer words, pictures, and sounds.
  • If you are using contrasting colors in your graphics, make sure they are WCAG 2.0 AA compliant. If you’re not sure, you can use the WebAIM color contrast checker. This includes slides, code editor screens, or any other imagery used in the lesson.
  • To find images, you can use resources like WordPress Photo Directory, Openverse, or Pexels, Pixabay, or UnSplash, but do take time to check each image’s license to ensure you are using the images correctly.

Top ↑

Step 5: Choose video software and ensure clear sound

Choose software for recording your video and making any necessary edits. Follow the video best practices guide for suggested software options, tips on recording video and audio, and accessibilityAccessibility Accessibility (commonly shortened to a11y) refers to the design of products, devices, services, or environments for people with disabilities. The concept of accessible design ensures both “direct access” (i.e. unassisted) and “indirect access” meaning compatibility with a person’s assistive technology (for example, computer screen readers). ( guidance.

Top ↑

Step 6: Record and edit your Lesson

Now that you have gathered all the necessary information and tools, you can start recording your video.

If possible, recording your lessons in a single take avoids the need for elaborate editing afterwards. On the other hand, if you tend to make lots of audio bloopers, you can retake portions of your lesson – allowing a few seconds in between each take – and edit out the glitches later.

If recording on a laptop, make sure it’s on a steady surface that won’t move, like a table.

Record a brief test video first and watch it back to see if there is anything not working well, paying attention to the image as well as sound. Adjust as needed before recording the real thing.

Make sure to speak clearly and slowly. It’s often better to slow down slightly from your usual conversational voice, as it makes it easier for the viewer to understand. 

Start your Lesson video with an introductory slide and a clear introduction. 

Share the objectives or outcomes of the Lesson to help guide the viewer. Learning objectives are more powerful if they are actionable and measurable. Try and create learning objectives that follow Bloom’s Taxonomy, starting each objective with a verb.

Aim for your Lesson to be between 5 – 10 minutes in length. Shorter videos can be more engaging and easier to follow for viewers. 

Once you’ve recorded your Lesson, it is time to edit. Cut out any mistakes and place your recording in the correct order. Watch through it once or twice, to make sure there are no mistakes or further edits required.

When your Lesson is ready for review, you can submit your Lesson to the Training Team for review. This can be done by uploading the video to the GitHub Lesson issue. If you have the video hosted on an external service like Vimeo, you can link to it in the issue.

Last updated: