Upload a Theme to the WordPress Repository

Description

In this lesson, you will learn how to submit a theme to the WordPress repository.

Objectives

After completing this lesson, participants will be able to:

  • Understand the theme requirements before submitting a theme
  • Submit a theme using a zip file
  • Update a theme while waiting for review
  • Understand the review status and result
  • Submit theme updates once approved

Prerequisite Skills

Participants will get the most from this lesson if they have:

Readiness Questions

  • Did you check the theme requirements
  • Are you ready to submit your theme to the directory?

Materials Needed

  • Participants will need a theme to upload.

Notes for the Presenter

  • Participants should check their themes using the theme requirements before submitting a theme. Errors could result in rejection.

Lesson Outline

  • Highlight the theme requirements
  • Discuss the Trac ticket system
  • Demonstrate how to submit a theme
  • Discuss the status during the review process
  • Demonstrate how to update a theme while waiting for review
  • Demonstrate how to upload a theme update after approval

Exercises

Once a theme is developed, check the requirements, and ready to submit the theme, ask participants to create a zip file and submit it via the theme submit page.

Assessment

How do I submit a theme?
a. By sending an email attachment
b. By uploading a zipped theme file on WordPress.org
c. By sending a URL to my portfolio website

Answer: b

How do I track the review status once a theme is uploaded?
a. Using the trac ticket system
b. Contacting the reviewer by emails
c. No progress status until a theme is approved

Answer: a

Why do you submit a theme to the WordPress directory?
You can help website owners and the WordPress community by sharing your design and development skills.

Additional Resources

Example Lesson

Theme requirements

It is important for theme developers to review their own themes using the theme requirements. 3 or more issues can result in rejection.

Trac ticket system

WordPress themes review uses the Trac ticket system to keep track throughout the review process. The theme developer can expect the following after submitting a theme.

  • The ticket will be provided for your theme after submitting a theme. Your theme will be sorted into the NEW queue with the ticket number.
  • When a reviewer starts to review your theme, your theme will be moved to the Tickets Under Review queue. You will also receive an email as the status progress.

Uploading a theme

First, it is recommended to read the Getting Started page. It describes the benefit of submitting a theme to the WordPress directory and the summary of the guidelines and resources.

A theme can be uploaded on the Upload Your Theme page. A theme must be a compressed zip file. Select a theme zip file, and agree with the three terms before uploading a theme.

Note: Make sure to have a correct name under Theme Name in the header section in style.css. The theme name and slug cannot be changed once a theme is uploaded.

Selecting and uploading a zipped theme file to the directory.
Selecting and uploading your zipped theme file

Status on the Trac system

There are several status changes throughout the review process. Each time the status changes, the theme author receives a notification email.

  • New – A theme is uploaded successfully, and a ticket was created. It is not assigned a reviewer yet.
  • Reviewing – A reviewer was assigned, and it is under review.
  • Closed theme (Live) – A theme was approved and live on the directory.
  • Closed theme (not-approved) – A theme was not approved

Update a theme while waiting for review

If a theme developer finds corrections while still waiting for review, upload the theme as the previous step on the Upload Your Theme page. It is recommended to update the changelog and version in style.css and readme.txt.

Theme developers must not upload themes while the theme is still in production. It is considered as a placeholder or a queue stander and causes queue clogging.

Updating a theme after it is approved and it is already in the directory

Theme developers can update the theme the same way using the Upload Your Theme page. It is recommended to update the changelog and version in style.css and readme.txt.

Lesson Wrap Up

💡 Follow with the Exercises and Assessment outlined above.
Duration 15 mins
Audience Developers
Level
Type Tutorial
WordPress Version
Last updated Apr 19th, 2023

Suggestions

Found a typo, grammar error or outdated screenshot? Contact us.