SEOshop Documentation


Version 2.3, last edit: February 9, 2016

This checklist contains the functional and design requirements for theme development. We recommend to reading this checklist thoroughly before starting to develop a theme. For more information please take the time to read the checking procedure page as well.

NOTE: All themes need to be created from a global perspective. English must be the default language in all locations.

NOTE: Treat all criteria contained on this page as MANDATORY. While we may be more lenient or strict on some points, we may refuse or de-list your theme if you fail to pass validation present on this page

Localisation criteria

These criteria must be respected to ensure an international rollout of your theme

Languages : [NoAm cluster: English, French (optional)] [EU cluster: English, Dutch, German]
Demo store language : The language of the shop where your theme is developed must be English first and you must use the 't' translation flag.
Currencies : Different currencies are displayed and work properly ($, £, €)
Back-end settings language : The language of the user customization settings
Documentation : The language of the theme documentation
Theme Store description : The description users will see when choosing a theme with the correct structure (see Publish a theme - point 2)
German laws : [EU cluster only] See the special rules : German Legislation
Changelog : A Maximum of 5 of your most recent additions with dates, either on the Theme Store description or in the Documentation

Front-end criteria

These criteria must be respected to ensure merchants have every default shop element active as they install your theme on their shop

Cart is present on all pages
Payment methods are present on all pages
Links to Service Pages are present on all pages : About us, Terms and conditions, Disclaimer, Privacy Policy, Payment Methods, Shipping & Returns, Customer service, Sitemap
A link to the Blog functionality is present on all pages
Links to Account / Registration / Login are present on all pages
Newsletter form is present
Search field is present
All elements are properly aligned (pixel-perfect)
Distinctive and Relevant Theme
All elements have sufficient contrast
Mobile footer is optimized : Links are big and easy to tap on mobile
Price and discounts displayed in collection (shop.url/collection)
Multiple image dimensions (vert, horizon) possible in collection (shop.url/collection)
Sort by grid/list option in collection (shop.url/collection)
Filter options and custom filters in collection (shop.url/collection)
Pagination in collection (shop.url/collection)
User Text (from Text pages in backend) displayed on homepage
Tags present on the homepage
RSS / Sitemap link present
Product zoom or enhancement present
Product details are present
Product links are present
Product reviews are present and can be added

Back-end criteria

These criteria must be respected to ensure merchants get a clear representation of all the customization settings available to them

Settings are cleanly laid out and there aren't too many or too few displayed
Settings are explained clearly and in detail : ex: Footer image - choose your footer image is not clear or useful, a better example would be Footer image, this image will be displayed at the bottom-left of every page
All colors present in the front-end can be customized
Background image can be customized
Background image option to repeat (no repeat, repeat, horizontal, vertical)
Logo or header can be customized
Favicon can be customized
Banners and USPs have options for multiple languages : Either an image upload for each language or a text input for each language

*Please note: If the used translation is not available in the SEOshop Backoffice it is essential to mail all information to Please use an Excel-file that outlines all translations (in enumeration).

Code criteria

These criteria must be respected for security reasons and to cut down on the number of possible bugs

All required templates are present : layout/custom.rain, layout/fixed.rain, page/brands.rain, page/catalog.rain, page/collection.rain, page/index.rain, page/product.rain, page/tags.rain, page/textpage.rain, snippet/messages.rain
fixed.rain - Responsive GUI files are present : Click here for details
fixed.rain - Include only url_core or Scheme-Less urls in head
fixed.rain - snippets/messages.rain may not be included
fixed.rain - HTML5 Semantic tags < header >, < nav > , < main > and < footer > are used
product.rain - Discount rules are present
Bundle products are present in either collection.rain or product.rain

Demo shop criteria

These criteria must be respected to your demo shop showcases your theme to merchants properly and is displayed correctly on our Theme Store

Different color scheme used for each preset
Different fonts used for each preset
Different navigation and/or logo placement for every preset
A unique logo for each shop preset
Headlines with active link (english if text present)
Banner with active link present (english if text present)
Brand images are present
Banners and USPs have options for multiple languages
About 20 Products added to about 5 Categories minimum
Products have descriptions (english or lipsum), tags, custom fields, specifications, brand, stock, and delivery times
A few products have Old / New prices
Related products are displayed
Blog should be activated and designed (English or lipsum)
Complete text pages (customer service, about us, etc) in English or lipsum
Activate payment methods/hallmarks/widgets
Have good screenshots in the correct template page in English in the Theme Store
Do not display any v1 screen shots in the documentation, only v2

*Please note: Deliver the setting translations (Dutch, German, ...) using this Excel-file so that we can implement them in the SEOshop Backoffice (send to

Performance criteria

These criteria must be respected to ensure your page adheres to the most widely accepted internet conventions

All pages are W3C validated :
Google PageSpeed Insights: 65 (mobile) and 85 (desktop) :
No Javascript errors in Console
No 404 errors in Console
SEO check (ex:
No Google Structured Data (snippet) errors :
Go through a dummy order to verify the process works
Nested categories (sub sub categories) work
Theme can handle very long text values
Theme can handle very small and very large images
Theme works well on all current Devices
Theme works well on all current Browsers
Was this article helpful? Yes No
One moment please
Thanks for your feedback.