FAQ

Here you’ll find a collection of the most commonly asked questions, mostly 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.orgWordPress.org 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. https://wordpress.org/ pluginPlugin A plugin is a piece of software containing a group of functions that can be added to a WordPress website. They can extend functionality or add new features to your WordPress websites. WordPress plugins are written in the PHP programming language and integrate seamlessly with WordPress. These can be free in the WordPress.org Plugin Directory https://wordpress.org/plugins/ or can be cost-based plugin from a third-party 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 team moderator either in-ticket or via SlackSlack Slack is a Collaborative Group Chat Platform https://slack.com/. The WordPress community has its own Slack Channel at https://make.wordpress.org/chat/. 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 pingPing The act of sending a very small amount of data to an end point. Ping is used in computer science to illicit a response from a target server to test it’s connection. Ping is also a term used by Slack users to @ someone or send them a direct message (DM). Users might say something along the lines of “Ping me when the meeting starts.” a team moderator 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.

The exceptions are themes that have not been updated in two years. These themes are manually reviewed before they go live. Remember that all themes, even old ones, need to follow the current requirements.

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 representative to request your theme to be removed from the repository. Alternatively, please contact a team representative in the #themereview channel on Slack. You can find team representatives 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 ↑

How can I add the 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). (https://en.wikipedia.org/wiki/Accessibility)-ready tag to my theme? How can I add the accessibility-ready tag to my theme?

If your theme is in the review queue, you can add the tag to the style.css file. It will then be placed in a queue that is specific for accessibility reviews.

If your theme is live, you can only add the accessibility-ready tag once your theme passes an accessibility review. To request a review, ping one of the team representatives in your themes latest TracTrac Trac is the place where contributors create issues for bugs or feature requests much like GitHub.https://core.trac.wordpress.org/. ticket, send an email to [email protected], or request a review via the themereview Slack chat.

Top ↑

What do I do if my theme name is already in use? What do I do if my theme name is already in use?

If there is a theme by this name that has active installs, the only thing you can do is rename your theme.


Top ↑

Reviewers: Reviewers:

Top ↑

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

Select a theme from the top of the new queue. Add a comment to the ticket, explaining that you are starting the review. A moderator will assign the ticket to you as soon as they have the time.

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 sidebarSidebar A sidebar in WordPress is referred to a widget-ready area used by WordPress themes to display information that is not a part of the main content. It is not always a vertical column on the side. It can be a horizontal rectangle below or above the content area, footer, header, or any where in the theme., 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.

You can also use the report button in the theme directory. The message is then sent to the team representatives.

Top ↑

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

Assigning badges is a manual process. There is no specific number of reviews to be a reviewer. It depends upon the quality of the reviews performed.

To apply for a reviewer badge, follow this link: https://profiles.wordpress.org/associations/theme-review-team/

When approved, a Theme Reviewer badge will appear on your wordpress.org profile page.

Last updated: