Define an editable content block specific to the page. If you're looking to add a content block that appears on more than one page you should check out the <ev:translate> tag.

The following templates support the <ev:editable> tag:

  • category
  • page
  • product

Developers/designers can add default or example content within the <ev:editable> regions to help content writers get started.


Optionally set the hexidecimal tab and border colour that appears within the CMS Editor for this editable region. If not set evEditable will use the default colour (Cyan).


Please ensure that all editable regions have a ref attribute. Evance will not know where to assign content without a reference. On product and category you must use specific references (listed below), CMS Pages must have at least one <ev:editable> with a reference of "Main", but may contain any number of other editable regions. 

Note: Please do not put other <ev:tags> within the <ev:editable> tag. 

Shop Category Pages 

The default shop category page for your theme should be located at shop/index.evml. You can create additional shop/[name].evml templates. These templates may contain the following <ev:editable> regions:

<ev:editable ref="primaryContent">...</ev:editable>
<ev:editable ref="secondaryContent">...</ev:editable>

Product Profile Pages 

The default product profile page for your theme should be located in product/index.evml. You can create additional product/[name].evml templates. These templates must contain the following <ev:editable> regions:

<ev:editable ref="fullDescription">...</ev:editable>

CMS Pages

There's no default CMS page for your theme, but all of your CMS page templates should be located in the cms directory of your theme. All of these templates should include at least the following <ev:editable. region:

<ev:editable ref="main">...</ev:editable>

Adding boilerplate content

When you're creating a template, whether for a product, category or CMS page you can add boilerplate, or default content, into your <ev:editable> tags. This helps you experiment with your templates without having to use the CMS editor to edit and preview content. For example you could create a page with the following content:

<ev:editable ref="main">
    <h1>Hello, welcome to our store</h1>
    <p>Perhaps you'd like to browse our awesome range of products.</p>

This allows you to be a little creative and when your theme is installed for the first time users aren't met with a blank space.

COVID-19 NOTICE – Business as Usual
Evance continues to provide all services and support throughout this difficult period. See our full statement here .