The Most Common Reasons For Product Improvement Requests

Zipping issues

  • Wrong archive structure. Please, refer to the rules and conditions of structuring a product archive.

Aesthetic issues:

  • Issues caused by the readability of design elements. Some elements of your site’s design are difficult to read or feature poor contrast to other elements. Make sure that all blocks of your website make clever use of contrast, are easy to read, and feature smartly organized color schemes. You can learn more about web design contrasts and readability here.
  • Typographic inconsistency. The theme’s typography should be polished. Make sure that content hierarchy is applied clearly on all pages and in all blocks of the design. To get a better understanding about the typographic hierarchy, follow this link.
  • Wrong visual hierarchy. Make sure that the theme utilizes the common, logical principles to highlight essential design blocks and group the most significant elements. To get a clearer understanding of the key visual hierarchy principles and their proper use, read this.
  • Inconsistent use of tabs and spaces. Make sure that your work is formatted properly. Double check that there is clear logic in the way your design’s elements are organized into tabs and the way spaces are used. Refer to the the detailed article to get a better understanding of the issue
  • Color scheme. The chosen color scheme should be polished. You can find more information in the following article.
  • Font choices. The choice of typography is of significant importance in the creation of a visual hierarchy of web designs. Make sure that the chosen fonts fit your work logically.

Product Quality and Functionality Issues

  • Documentation. Documentation is either missing or needs further improvement. Provide users with detailed and easy-to-follow documentation, making it easier for the end user to work with your theme.
  • Titles of groups and layers in PSD files. In PSD files, all layers and groups should be properly named and organized in a logical order. Keep the end users in mind when working on the creation of PSD files.
  • All groups should be collapsed. Before saving PSD files, make sure that all groups of layers are collapsed.
  • Replacing images with placeholders. Replace all commercial images with placeholders, except for the cases where your license allows you to apply images to the end product.
  • Blog publications display. Test all blog publications and post formats with Theme Unit Test
  • Widget stylization. Double-check that all standard WordPress widgets are styled properly, and seamlessly perform in all widget areas and on all devices.
  • Mobile friendliness. Make sure that all design elements are stylized to be properly displayed on mobile devices. Child theme issues. Child theme doesn’t install or causes issues in the work of the parent theme.

CSS Guidelines

Use of inline CSS style is prohibited.

CSS file is poorly documented. Divide a CSS file into logical blocks, title them, and add a table of contents.

CSS specificity. You need to enhance CSS specificity and avoid “!important”.

Make sure the CSS file is well documented with a proper table of contents.

The source files CSS and JS should be included in the product archive. The end-users should have the opportunity to customize the code of the template, so the code could be readable and editable.

Code Standards

Minification and obfuscation can be applied to the product demo, but in the product archive the source files are required. The end-users should be given an opportunity to edit the code in accordance with their needs.

Use local files for jQuery instead of CDN.

The template should be built with valid HTML. Follow this link to check Markup Validation Service –

JavaScript should be used at the bottom of the page.

Make sure that the code is properly formatted and is easy to read.

The code should be correctly indented and that it’s consistent with the use of spaces or tabs for indentation of the code. We do not give preference to any, but we need the author to pick one and use it for all the code.

Scripts and styles should not be hardcoded anywhere in your theme.

Please make sure your theme doesn’t raise any errors or warnings in the console.

The localization file should be in English.

Translate all strings within the PHP variable and escape where needed.

The template’s functionality can be established within the template’s source files or can be applied as plugins. Both cases are acceptable, but should be described in the product documentation.

Best coding practices:

Live Demo

Using HTTPS (SSL) for the product Live Demo is strongly recommended.

Please add a good Demo Importer (One Click Demo Import or All-in-One WP Migration), that will guarantee a complete design coincidence with your Demo (all blocks, sliders, menus, shortcodes etc.). And pay attention that the template must look exactly the same as the demo theme.

Please make sure that Contact form is working and include necessary scripts/files to send out emails. Otherwise, the product’s demo is misleading and customers can request a refund due to the lack of functionality.

Do not use ‘target=”_blank”‘ links in your Live Demo (Shopify Splash Page is an exception).

The usage of third-party plugins, modules and extensions is welcomed, but it should be included to the product archive and described in the documentation.

If the author includes the third-party software to the product, the author is supposed to guarantee the compatibility of the product and third-party software.

If the author has no appropriate license to use the third-party software and yet includes it to the product archive, the author will be responsible for copyright infringement in case of escalations.

General Requirements

PSD version of the product is not mandatory for website, CMS and E-Commerce products.

Follow this link to check Product Archive Requirements

Please make sure to declare cross-browser compatibility in the product description and documentation.

The template layout must be responsive and consistent with any screen resolution.

Related articles:

10 Things to Note for Developing Responsive Websites

Responsive Website Coding: Cheat Sheet

Please use the latest version of the software (engine, plugins, modules etc.,) and update your product regularly to keep it fit current versions. Otherwise, the template can be declined or removed from sale as an outdated product.

Can`t find the answer to your question?