FAQ

Here you’ll find a collection of the most commonly asked questions relating to the theme review process.

The questions have been categorized into two groups. Those which are most relevant to theme authors, and those which are most relevant to theme reviewers.

Authors: Authors:

When will my theme be reviewed? When will my theme be reviewed?

The review duration varies. Each theme is reviewed manually, line by line, so there is no precise timeframe on when your theme will be reviewed. Themes are reviewed on a first come first serve basis, you can keep track of your themes position in the queue here:

https://themes.trac.wordpress.org/report/2

Top ↑

Can I recommend plugins with TGMPA? Can I recommend plugins with TGMPA?

Yes. Any plugins that are recommended must be from the WordPress.org plugin repository. Plugins from 3rd party sites or bundling plugins directly with the theme is not permitted.

The theme must work fully without the need to install any recommended plugins. Moreover, recommended plugins should be relevant and integrated somehow to your theme. Adding plugins in the recommended list just for advertising purpose is not allowed.

Top ↑

How do I find text that is not translation ready? How do I find text that is not translation ready?

Theme authors should ensure they understand every single line of their code. There is currently no automated method to detect strings that need to be made translation ready, as such please review your code line by line to detect such issues.

There are a number of plugins that can be used to aid in this task (e.g. Pig Latin). However, such plugins should not be seen as an alternative to manually reviewing your theme code in full.

Top ↑

What do I do if my reviewer is not responding? What do I do if my reviewer is not responding?

If there is no response from the assigned reviewer for 48 hours, you are free to contact a theme mod either in-ticket or via Slack in the #themereview channel. Abandoned tickets will be returned back to the review queue giving the opportunity for a new reviewer to continue the review.

Top ↑

What do I do if my reviewer asks me to change things that are not listed as required? What do I do if my reviewer asks me to change things that are not listed as required?

If you do not agree with reviewers feedback you are free to request a second opinion for confirmation on whether the issue is genuine or not. Please ping a theme mod in the ticket.

Top ↑

How do I update my theme (and do I have to wait)? How do I update my theme (and do I have to wait)?

Themes can be updated in the same way as a new theme submission. Please login to your WordPress account and navigate to wordpress.org/themes/upload. You can upload your theme as normal.

When uploading your theme please ensure that the version number is higher than the version currently in the repository. The update will be set live shortly after submission and is not manually reviewed. Regardless, your theme must comply with the latest WordPress guidelines. Circumventing guidelines through abuse of the automated review for updates may result in theme suspensions.

Top ↑

How do I remove my theme? How do I remove my theme?

Comment in the most recent ticket for your theme cc’ing a team leader to request your theme be removed from the repository. Alternatively, please contact a team leader in the #themereview channel on Slack. You can find team leaders here.

Top ↑

How do I transfer my theme to another user? How do I transfer my theme to another user?

You can only transfer already live theme to another user. Ping any team leader with the details and they will handle the transfer. You can find team leaders here.

Top ↑

Can I update the theme when ticket is in admin queue (approved but not live)? Can I update the theme when ticket is in admin queue (approved but not live)?

Tickets can be updated when in the admin a queue. However, it is discouraged as the final reviewer may need to review your entire theme again. Additionally, a new ticket will be created recognizing the update as a new submission. This will not impact your position in the review queue, as the final reviewer will pick the ticket from the admin queue as normal.

Top ↑

My ticket is approved and it is now in admin queue. Can I upload another theme? My ticket is approved and it is now in admin queue. Can I upload another theme?

According to “one active ticket per author” rule effective from 23 August 2016, an author is allowed to have only one active tickets in the system. Author cannot submit new theme until their earlier ticket is closed as either not-approved or set live.

Top ↑

Reviewers: Reviewers:

Top ↑

How can I assign a ticket to myself for review? How can I assign a ticket to myself for review?

New reviewers can request a theme to review by pressing the “Review a Theme” on the theme review team handbook page, which can be found here.

Top ↑

I am reviewing a theme. How can I get another ticket for review? I am reviewing a theme. How can I get another ticket for review?

Anyone can pick a ticket for review, if you don’t have the permission level to assign a ticket to yourself please simply pick the first theme in the queue and make a comment pinging a team lead requesting that the ticket be assigned to yourself.

Tickets should always be picked from the top of the following queue:

https://themes.trac.wordpress.org/report/2

Top ↑

How do I report a problem with a theme that is live? How do I report a problem with a theme that is live?

If you find any problem in the live theme in the directory, you can ping theme author and inform about the issue. To do this follows the steps below:

  • Go to theme page in the directory.
  • In the right sidebar, you can find “Trac Tickets” link under “Browser the Code” section.
  • You will see list of trac tickets of the theme.
  • Find the latest version ticket and post your comment there.

Top ↑

When will I get the Reviewer badge on my profile? When will I get the Reviewer badge on my profile?

A Theme Reviewer badge will appear for the reviewer on their wordpress.org profile page after the reviewer is promoted to the Reviewer status from Trainee Reviewer status. This is a manual process with the team leads managing the assignment. There is no specific number of reviews to be a Reviewer. It depends upon the quality of the reviews performed. After being assigned the Reviewer status the theme reviewer badge list is updated twice a year.