Title: Feedback requested:  Resolution process for issues found in live themes
Author: williampatton
Published: November 19, 2020
Last modified: December 8, 2020

---

 [  ](https://profiles.wordpress.org/williampatton/) [williampatton](https://profiles.wordpress.org/williampatton/)
11:41 am _on_ November 19, 2020     
Tags: feedback, [Themes team ( 207 )](https://make.wordpress.org/themes/tags/themes-team/)

# Feedback requested: Resolution process for issues found in live themes

Thank you to everyone who participated in the [discussion](https://make.wordpress.org/themes/2020/08/11/what-should-happen-when-a-theme-in-the-directory-doesnt-follow-the-guidelines/)
a few months ago about how this team should address issues that are discovered with
themes that are live in the directory!

It’s great when people are willing to share their thoughts about the ideal or preferred
way to resolve problems, because it helps the team understand what theme authors
expect and prefer — which helps reviewers design a process that is less surprising
for theme authors.

The purpose of this post is to gather feedback on a proposal for how this team should
address issues found in themes that are already live in the directory.

**All feedback is welcome, but in particular, it would be helpful to know:**

 1. Are there any parts of this process that might be unclear or confusing?
 2. Does the process seem too strict, too permissive, or just about right?
 3. Should anything be added to this process _(keeping in mind that all reviewers are
    volunteers who have limited time available)_?
 4. Does this process fail to address any significant issues or steps needed for resolution?

---

## Resolving low- to moderate-impact issues

Some examples of low-impact or moderate-impact issues are:

 * Screenshot issues
 * Overuse of content creation in customizerCustomizer Tool built into WordPress
   core that hooks into most modern themes. You can use it to preview and modify
   many of your site’s appearance settings.
 * 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/](https://wordpress.org/plugins/)
   or can be cost-based plugin from a third-party. functionality type features
 * Demo content import
 * Failing to meet expectations/guidelines which were added more than 6 months ago
 * Recommending plugins without reason or good integration in the theme

### Resolution process: 

When a theme reviewer notices that a live theme does not match the theme guidelines,
a theme author should expect the following steps:

 1. The theme author will be emailed with an explanation of the issue(s) and a request
    to resolve them. The email will include a deadline for the requested changes, which
    will allow the author at least 7 days to submit changes, and a link to a page with
    information about the resolution process. 
 2. If the changes are submitted before the deadline, then
 3.  a. they will be reviewed and approved, or 
     b. the author will be informed of additional changes that must be made. 
 4. If changes that resolve the issue are not submitted on time, then the theme may
    be “delisted” until the issues are resolved. 
 5. Once the theme is delisted, if the theme author does not submit changes that resolve
    the problem within 3 months, the theme will be suspended until the changes have
    been resolved. 

## Resolving high-impact issues 

Some examples of high-impact issues are:

 * License issues
 * Security issues
 * User tracking-related issues
 * User Consent Issues 
 * Advertising, promoting or otherwise endorsing any real products and/or services
   on the front (except the theme credit link)
 * PHPPHP PHP (recursive acronym for PHP: Hypertext Preprocessor) is a widely-used
   open source general-purpose scripting language that is especially suited for 
   web development and can be embedded into HTML. [https://www.php.net/manual/en/index.php](https://www.php.net/manual/en/index.php)
   Fatal Errors* (If a theme is found to throw fatal errors on activation, it is
   not compatible with modern (PHP 7+) or they are not compatible with the most 
   recent versions of WP.)

### Resolution process: 

*If a theme is found to have PHP errors, it will immediately be suspended until 
the author uploads fixes. _(This is to prevent the theme previewer error logs being
cluttered and to prevent new users running into the issue.)_

When a theme reviewer notices a high-impact issue in a live theme, a theme author
should expect the following steps:

 1. The theme author will be emailed with an explanation of the issue(s) and a request
    to resolve them. The email will also include:
 2.  a. A deadline for the requested changes, which will allow the author at least 3 days
        to submit changes. 
     b. An explanation of what will happen if the changes are not submitted in time, or
        if the changes don’t solve the issue(s).
 3. If the changes are submitted before the deadline, then
 4.  a. they will be reviewed and approved, or 
     b. the author will be informed of additional changes that must be made. 
 5. If changes that resolve the issue are not submitted on time, then the theme will
    be “delisted” or suspended until the issues are resolved. 
 6. Once the theme is delisted, if the theme author does not submit changes that resolve
    the problem within 3 months, the theme will be suspended until the changes have
    been resolved. 

## Repeated Issues

In the case of a theme author who demonstrates a pattern of failing to meet theme
directory expectations when updating themes  — for example, by breaking a certain
guideline repeatedly after correcting it in the past, or by breaking different guidelines
repeatedly in a period of 3-12 months, then all of the author’s themes may be suspended
from the directory, permanently. The author may appeal this decision with the Executive
Director (Josepha Haden Chomphosy) or Project Lead (Matt Mullenweg). 

---

### Exceptions

Sometimes special cases will be discovered, which can’t be resolved by the processes
described above. Those should be rare, but might include the following situations:

 * A theme passed the initial review and was added to the directory but should not
   have been added because it is a clone, or for other foundational reasons. In 
   this case, the theme will be suspended immediately and the author will be warned
   that another attempt to submit a cloned theme to the directory will result in
   a lifetime ban. 

---

_Delisting_ as mentioned in the post, relies on the delisting option being implemented.

---

**The feedback period will be open until December 7th,** to allow the team representatives
time to summarize it for the December 8 biweekly meeting.
At that time, the team
will adjust the proposed process as seems necessary, and then publish the process
in the handbook.

Thanks for your time, and for sharing your themes on 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/](https://wordpress.org/)!

[#feedback](https://make.wordpress.org/themes/tags/feedback/), [#themes-team](https://make.wordpress.org/themes/tags/themes-team/)

### Share this:

 * [  Threads ](https://make.wordpress.org/themes/2020/11/19/feedback-requested-resolution-process-for-issues-found-in-live-themes/?share=threads)
 * [  Mastodon ](https://make.wordpress.org/themes/2020/11/19/feedback-requested-resolution-process-for-issues-found-in-live-themes/?share=mastodon)
 * [  Bluesky ](https://make.wordpress.org/themes/2020/11/19/feedback-requested-resolution-process-for-issues-found-in-live-themes/?share=bluesky)
 * [  Facebook ](https://make.wordpress.org/themes/2020/11/19/feedback-requested-resolution-process-for-issues-found-in-live-themes/?share=facebook)
 * [  X ](https://make.wordpress.org/themes/2020/11/19/feedback-requested-resolution-process-for-issues-found-in-live-themes/?share=x)
 * [  LinkedIn ](https://make.wordpress.org/themes/2020/11/19/feedback-requested-resolution-process-for-issues-found-in-live-themes/?share=linkedin)

 1.  ![](https://secure.gravatar.com/avatar/ad54fee87b0057de02d3b3f5af8638dd50aece094c8c5b3da65415df11c092df?
     s=32&d=mm&r=g)
 2.   [ILOVEWP](https://profiles.wordpress.org/ilovewpcom/)  12:03 pm _on_ November
     19, 2020
 3.  Hey William,
 4.  There is some inconsistency in the text.
 5.  > *If a theme is found to have PHPPHP PHP (recursive acronym for PHP: Hypertext
     > Preprocessor) is a widely-used open source general-purpose scripting language
     > that is especially suited for web development and can be embedded into HTML.
     > [https://www.php.net/manual/en/index.php](https://www.php.net/manual/en/index.php)
     > errors, it will immediately be suspended until the author uploads fixes.
 6.  But then you go on to say that the author will be emailed and will have 3 days
     to upload a fix, otherwise the theme will be delisted or suspended.
 7.  The way I see this update is that there will be no real punishment in those cases
     when theme authors are active and can fix issues in the first 72 hours.
      So authors
     can “accidentally” break a guideline or two once or twice a year without any repercussions.
 8.  Or is there something that I’m missing?
 9.   * ![](https://secure.gravatar.com/avatar/2bbf5d68008a40dd09df7de61b7f06de29163885ca93e8b9706574aadc07ff12?
        s=32&d=mm&r=g)
      *  [dingo-d](https://profiles.wordpress.org/dingo_d/)  12:30 pm _on_ November
        19, 2020
      * There is no punishment. The people working in the team are team representatives,
        not punishers 😉
         - ![](https://secure.gravatar.com/avatar/d401f6723c24ce90038075be6a7990d02d2d7480fa3735f3697832fe393557d5?
           s=32&d=mm&r=g)
         -  [williampatton](https://profiles.wordpress.org/williampatton/)  12:42 pm
           _on_ November 19, 2020
         - 😀♥️
      * ![](https://secure.gravatar.com/avatar/d401f6723c24ce90038075be6a7990d02d2d7480fa3735f3697832fe393557d5?
        s=32&d=mm&r=g)
      *  [williampatton](https://profiles.wordpress.org/williampatton/)  12:32 pm _on_
        November 19, 2020
      * Sure, if someone accidentally has an issue every 6-12 months they would have
        no direct repercussions provided they resolve the issues when asked.
      * If it was a persistent pattern though the final option would be invoked and
        the themes would be removed for repeatedly failing to meet the expectations
        of the directory. I hope to never have to reach this point but if we do then
        this policy is here to guide how it is handled.
      * ![](https://secure.gravatar.com/avatar/ee688e454076072936e2f07ceea1727351cda523c1c8925b90e5040a858463e1?
        s=32&d=mm&r=g)
      *  [Carolina Nymark](https://profiles.wordpress.org/poena/)  6:35 am _on_ December
        6, 2020
      * If you have actionable suggestions for improvements then please share them 
        here before December 8.
 10. ![](https://secure.gravatar.com/avatar/ee688e454076072936e2f07ceea1727351cda523c1c8925b90e5040a858463e1?
     s=32&d=mm&r=g)
 11.  [Carolina Nymark](https://profiles.wordpress.org/poena/)  12:12 pm _on_ November
     19, 2020
 12. The star ( * ) is there to mark the exception for this requirement.
 13. ![](https://secure.gravatar.com/avatar/3580c89c6189fc3e3462675c4b62a11bb1fbfd2597243637e4b36d7aefca30e4?
     s=32&d=mm&r=g)
 14.  [Schwarttzy](https://profiles.wordpress.org/schwarttzy/)  6:22 pm _on_ November
     19, 2020
 15. Is there an example of “Overuse of content creation in customizerCustomizer Tool
     built into WordPress core that hooks into most modern themes. You can use it to
     preview and modify many of your site’s appearance settings.”? I’d like to avoid
     my theme Semper Fi Lite becoming labeled that.
 16.  * ![](https://secure.gravatar.com/avatar/ee688e454076072936e2f07ceea1727351cda523c1c8925b90e5040a858463e1?
        s=32&d=mm&r=g)
      *  [Carolina Nymark](https://profiles.wordpress.org/poena/)  10:45 am _on_ November
        26, 2020
      * When you are not sure **it is always best to ask first**, but in the ticket,**
        with full context**, descriptions and examples.
      * Only minor content creation is allowed. There are no set numbers. Don’t add
        large text sections that causes the user to lose their entire front page content
        when they switch themes.

Comments are closed.

# Post navigation

[← Theme previews in the time of blocks](https://make.wordpress.org/themes/2020/11/18/theme-previews-in-the-time-of-blocks/)

[Gutenberg + Themes: Week of Nov 16, 2020 →](https://make.wordpress.org/themes/2020/11/20/gutenberg-themes-week-of-nov-17-2020/)