Title: Creating a Tutorial
Author: Hugh Lashbrooke
Published: November 15, 2021
Last modified: July 8, 2024

---

# Creating a Tutorial

## In this article

 * [Add the Tutorial creation checklist to GitHub](https://make.wordpress.org/training/handbook/guidelines/tutorials/creating-a-tutorial/?output_format=md#add-the-tutorial-creation-checklist-to-github)
 * [Creating Your Tutorial](https://make.wordpress.org/training/handbook/guidelines/tutorials/creating-a-tutorial/?output_format=md#creating-your-tutorial)
    - [Step 1: Choose screen-recording software](https://make.wordpress.org/training/handbook/guidelines/tutorials/creating-a-tutorial/?output_format=md#step-1-choose-software)
    - [Step 2: Ensure Clear Sound](https://make.wordpress.org/training/handbook/guidelines/tutorials/creating-a-tutorial/?output_format=md#step-2-sound)
    - [Step 3: Graphics](https://make.wordpress.org/training/handbook/guidelines/tutorials/creating-a-tutorial/?output_format=md#step-3-graphics)
    - [Step 4: Naming your tutorial](https://make.wordpress.org/training/handbook/guidelines/tutorials/creating-a-tutorial/?output_format=md#step-4-naming-your-workshop)
    - [Step 5: Time](https://make.wordpress.org/training/handbook/guidelines/tutorials/creating-a-tutorial/?output_format=md#step-4-time)
    - [Step 6: Script](https://make.wordpress.org/training/handbook/guidelines/tutorials/creating-a-tutorial/?output_format=md#step-5-script)
    - [Step 7: Record your tutorial](https://make.wordpress.org/training/handbook/guidelines/tutorials/creating-a-tutorial/?output_format=md#step-6-record-publish)
    - [Step 8: The tutorial review period](https://make.wordpress.org/training/handbook/guidelines/tutorials/creating-a-tutorial/?output_format=md#step-8-the-tutorial-review-period)
    - [Step 9: Publish your tutorial](https://make.wordpress.org/training/handbook/guidelines/tutorials/creating-a-tutorial/?output_format=md#step-9-publish-your-tutorial)
    - [Step 10: Quiz (optional)](https://make.wordpress.org/training/handbook/guidelines/tutorials/creating-a-tutorial/?output_format=md#step-7-quiz)
 * [Frequently asked questions](https://make.wordpress.org/training/handbook/guidelines/tutorials/creating-a-tutorial/?output_format=md#frequently-asked-questions)

[↑ Back to top](https://make.wordpress.org/training/handbook/guidelines/tutorials/creating-a-tutorial/?output_format=md#wp--skip-link--target)

The Tutorial content type is deprecated and no new tutorials are being created. 
[Existing tutorials will be converted to Lessons](https://github.com/WordPress/Learn/issues/2393).

**Read this page in other languages:** [Gujarati (Google Doc)](https://docs.google.com/document/d/1od1R9vbuGTACuaqEsttFjIUu__LjQdwJWaPHd9SUhvg/edit),
[Italian](https://it.wordpress.org/team/handbook/training/tutorial/creare-un-tutorial/),
[Tamil (Google Doc)](https://docs.google.com/document/d/1Eh7Bi77fgFElsbQSSnkPuiIjPKh2SEsAemZJxfpwGXA/edit#heading=h.wy1gu655m07b)

The first step in creating a Tutorial is to decide a topic and have a Subject Matter
Expert (SME) vet it for you. You can do this in one of two ways:

 1. Choose a Tutorial topic that has already been vetted by an SME from [the Ready to Create tab](https://github.com/orgs/WordPress/projects/33/views/20)
    of the team’s content development project board.
 2. Submit a new **Content Development (general)** GitHub issue from https://github.
    com/WordPress/Learn/issues/new/choose and have an SME vet it for you.

If this is your first time creating a Tutorial, you’ll also want to submit a [tutorial presenter application](https://learn.wordpress.org/tutorial-presenter-application/).

If you haven’t yet, now’s a good time to familiarize yourself with the [team’s different resources](https://make.wordpress.org/training/handbook/guidelines/),
too.

Once your application has been approved, and your topic has been vetted, you are
ready to get started on your Tutorial! Bookmark your topic’s 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 by the repository owner. [https://github.com/](https://github.com/)
issue, as you’ll be using this to track your progress, and receive feedback from
other team members.

## 󠀁[Add the Tutorial creation checklist to GitHub](https://make.wordpress.org/training/handbook/guidelines/tutorials/creating-a-tutorial/?output_format=md#add-the-tutorial-creation-checklist-to-github)󠁿

Copy and paste the following checklist as a new comment in your content’s GitHub
issue. You can then use this checklist as your guide through the rest of the creation
process.

    ```wp-block-code
    # Tutorial Development Checklist

    - [ ] Tutorial [created](https://make.wordpress.org/training/handbook/tutorials/creating-a-tutorial) and announced to the team for Q/A review
    - [ ] Tutorial reviewed and [ready to publish](https://make.wordpress.org/training/handbook/tutorials/publishing-a-tutorial)
    - [ ] Tutorial [submitted and published to WPTV](https://make.wordpress.org/training/handbook/tutorials/publishing-a-tutorial/#1-submit-your-video-to-wordpress-tv) 
    - [ ] Tutorial published on WPTV
    - [ ] Tutorial [captioned](https://make.wordpress.org/training/handbook/tutorials/publishing-a-tutorial/#2-generate-subtitles-and-a-transcript-for-your-video) 
    - [ ] Tutorial [created on Learn.WordPress.org](https://make.wordpress.org/training/handbook/tutorials/publishing-a-tutorial/#3-create-edit-your-workshop-post)
    - [ ] Tutorial post reviewed for grammar, spelling, etc.
    - [ ] Tutorial published on Learn.WordPress.org
    - [ ] Tutorial [announced to Marketing Team](https://docs.google.com/spreadsheets/d/1rY9gyA0KljjlinPE2B0S2qfsN8Nz24_N_KzqB5CrYZM/edit#gid=469255212) for promotion
    ```

## 󠀁[Creating Your Tutorial](https://make.wordpress.org/training/handbook/guidelines/tutorials/creating-a-tutorial/?output_format=md#creating-your-tutorial)󠁿

### 󠀁[Step 1: Choose screen-recording software](https://make.wordpress.org/training/handbook/guidelines/tutorials/creating-a-tutorial/?output_format=md#step-1-choose-software)󠁿

Choose a suitable software program for recording your screen and/or audio, for example

 * [Descript](http://descript.com) (free to record for an hour a month)
 * [Open Shot ](https://www.openshot.org/download/)+ Built-In Screen Recording Technology(
   [Screen Recording for Mac Instructions](https://support.apple.com/guide/quicktime-player/record-your-screen-qtp97b08e666/mac#:~:text=In%20the%20QuickTime%20Player%20app%20on%20your%20Mac%2C%20choose%20File,clicks%20in%20the%20screen%20recording.)/
   [Screen Recording for PC Instructions](https://www.microsoft.com/en-us/windows/learning-center/how-to-record-screen-windows-11))
 * [Screenpal](https://screenpal.com/)
 * [Camtasia](https://www.techsmith.com/video-editor.html)
 * or another option

### 󠀁[Step 2: Ensure Clear Sound](https://make.wordpress.org/training/handbook/guidelines/tutorials/creating-a-tutorial/?output_format=md#step-2-sound)󠁿

Sound will play an important part in your tutorial, so try to use high-quality sound.
If you don’t have access to a microphone, use a headset if possible. There are also
noise-cancelling apps available, such as:

 * RNNoise
 * Neutralizer
 * Krisp
 * Adobe Audition
 * or another option

### 󠀁[Step 3: Graphics](https://make.wordpress.org/training/handbook/guidelines/tutorials/creating-a-tutorial/?output_format=md#step-3-graphics)󠁿

[The Training Team provides a title card template](https://docs.google.com/presentation/d/1MO3waL9tX8DSroif5SD6EtTnlMmv9k6TvqTxXxXa9Wo/edit?usp=sharing)
that you are welcome to use and modify to fit your needs. However, you are also 
welcome to select a graphics program, such as Canva, Google Slides, or Wordle to
create visually appealing slides, infographics and design elements.

To find images to use in tutorials, you can use resources like [OpenVerse](https://openverse.org/),
[Pixabay](https://pixabay.com/), or [UnSplash](http://unsplash.com), but do take
time to check each image’s license to ensure you are using the images correctly.

### 󠀁[Step 4: Naming your tutorial](https://make.wordpress.org/training/handbook/guidelines/tutorials/creating-a-tutorial/?output_format=md#step-4-naming-your-workshop)󠁿

Name your tutorial appropriately. Action words like create, use, explore, help to
draw the reader’s attention. Make sure to use sentence case on your title card.

### 󠀁[Step 5: Time](https://make.wordpress.org/training/handbook/guidelines/tutorials/creating-a-tutorial/?output_format=md#step-4-time)󠁿

Aim for your tutorial to be between 5 – 10 minutes in length. Shorter videos can
be more engaging and easier to follow for viewers. We also welcome longer WordCampWordCamp
WordCamps are casual, locally-organized conferences covering everything related 
to WordPress. They’re one of the places where the WordPress community comes together
to teach one another what they’ve learned throughout the year and share the joy.
[Learn more](https://central.wordcamp.org/about/). or MeetupMeetup All local/regional
gatherings that are officially a part of the WordPress world but are not WordCamps
are organized through [https://www.meetup.com/](https://www.meetup.com/). A meetup
is typically a chance for local WordPress users to get together and share new ideas
and seek help from one another. Searching for ‘WordPress’ on meetup.com will help
you find options in your area. type tutorials of 40-45 minutes duration. Please 
stay within the time frame which was approved. 

### 󠀁[Step 6: Script](https://make.wordpress.org/training/handbook/guidelines/tutorials/creating-a-tutorial/?output_format=md#step-5-script)󠁿

Write out your script or use an existing lesson plan! This is the part where you
gather all of your thoughts, develop an outline for what you would like to present,
and begin to work on any supporting materials, such as slides or screenshots.

### 󠀁[Step 7: Record your tutorial](https://make.wordpress.org/training/handbook/guidelines/tutorials/creating-a-tutorial/?output_format=md#step-6-record-publish)󠁿

Please keep these guidelines in mind when recording the tutorial video. 

 * [WPTV Submission Guidelines](https://blog.wordpress.tv/submission-guidelines/)
 * [Brand Guidelines for Learn WordPress](https://make.wordpress.org/training/2021/08/17/proposal-brand-guidelines-for-learn-wordpress-content/)
 * [Promotional Guidelines for Learn WordPress](https://make.wordpress.org/training/handbook/guidelines/promotional-guidelines/)
 * Ensure that media assets are [CC0](https://creativecommons.org/share-your-work/public-domain/cc0/)(
   you can make use of [WordPress.org/photos](https://wordpress.org/photos/) or 
   [Openverse](https://openverse.org/))
 * Start your tutorial video with an [introductory slide](https://docs.google.com/presentation/d/1TtKmC78RNAOMTDe-eBCSojEv7THKL91ZgncoT9N8OdQ/edit#slide=id.gb0e8335fcf_0_116)
   and clear introduction. 
 * Remember to share the objectives or outcomes of the tutorial to help guide the
   viewer. [Learning objectives](https://make.wordpress.org/training/handbook/guidelines/training-team-how-to-guides/how-to-finalize-description-and-objectives/)
   are more powerful if they are actionable and measurable.
 * When creating slides and graphics, keep the ‘coherence principle’ in mind: People
   learn better with less extraneous words, pictures and sounds.
 * Once you’ve recorded your tutorial, it is time to edit. Cut out any mistakes 
   and place your recording into the correct order. 
 * Submit your tutorial to the training team for a review. This can be done by either
   uploading the video to the GitHub tracking issue, or linking to it in the issue,
   if you have it hosted elsewhere.

### 󠀁[Step 8: The tutorial review period](https://make.wordpress.org/training/handbook/guidelines/tutorials/creating-a-tutorial/?output_format=md#step-8-the-tutorial-review-period)󠁿

The next step is to wait for a member of the training team to review your tutorial.
As a general rule, tutorials are left open for review for a period of two (2) weeks
from the date that they were made available for review.

It is recommended that there should be at least three (3) reviews completed on a
tutorial before it can be published.

However, this is more common with tutorials from newer contributors. Content creators
who have more experience preparing and publishing tutorials for Learn WordPress 
will typically publish after three reviews OR once the two-week review period has
concluded.

If you’re not sure, it’s always a good idea to check with a member of the training
team in the #training channel in SlackSlack Slack is a Collaborative Group Chat 
Platform [https://slack.com/](https://slack.com/). The WordPress community has its
own Slack Channel at [https://make.wordpress.org/chat/](https://make.wordpress.org/chat/).

### 󠀁[Step 9: Publish your tutorial](https://make.wordpress.org/training/handbook/guidelines/tutorials/creating-a-tutorial/?output_format=md#step-9-publish-your-tutorial)󠁿

When your video is ready and approved by the Training team, [upload it to WordPress.TV](https://wordpress.tv/submit-video/).
Where it says “categoryCategory The ‘category’ taxonomy lets you group posts / content
together that share a common bond. Categories are pre-defined and broad ranging.”
check the box that says “Learn WordPress.” Once the video is uploaded and published,
please [add subtitles to the tutorial](https://make.wordpress.org/training/handbook/tutorials/tutorial-subtitles-and-transcripts/).

Once the video is uploaded on WordPress.tv will be shared with the wider Training
team and other Make Teams.

### 󠀁[Step 10: Quiz (optional)](https://make.wordpress.org/training/handbook/guidelines/tutorials/creating-a-tutorial/?output_format=md#step-7-quiz)󠁿

Tutorial creators should also submit up to five quiz questions and answers with 
each tutorial. This will help learners test and solidify their newly acquired knowledge
and skills. Follow this [link](https://docs.google.com/document/d/1FTaNgissCpBhn4rHz2XOhf2ZCyzd-JoXX7hqzMfGyxI/edit#)
for more information.

## 󠀁[Frequently asked questions](https://make.wordpress.org/training/handbook/guidelines/tutorials/creating-a-tutorial/?output_format=md#frequently-asked-questions)󠁿

**Q: What are the technical specs for the video?**

A: You will be uploading your video to WordPress.TV, so please keep in mind its 
Video Submission Guidelines.

**Q: Is there a preferred length of recording?**

A: We don’t want to place an exact time limit on tutorials, but it is encouraged
to stay within 5 – 10 minutes, unless a longer version has been agreed.  

**Q: Do I need to share the link to my [slides](https://make.wordpress.org/training/handbook/guidelines/slides-style-guide/)?**

A: Not necessarily, but you can.  Many tutorial presenters tend to include their
slides in the video making.

**Q: I don’t feel comfortable editing, writing and speaking. Do I have to do it 
all?**

A: No! A lot of care and effort goes into making a video, or any presentation. If
there is a particular part of the process you excel at, feel free to include that
in your application or reach out in the [#training team channel](https://app.slack.com/client/T024MFP4J/C02RW657Q)
on the Make WordPress Slack to find if there would be anyone interested in helping
to divide the tasks with you. Tutorials can be created and presented by others in
the Training team or WordPress community.

First published

November 15, 2021

Last updated

July 8, 2024

[  Previous: Tutorial Template](https://make.wordpress.org/training/handbook/guidelines/tutorials/tutorial-template/)

[  Next: Preparing a Technical Tutorial](https://make.wordpress.org/training/handbook/guidelines/tutorials/creating-a-tutorial/preparing-technical-tutorial/)