πŸŽ‰ Β  New theme alert! Β  Check out Β  ETHERYX β†’
Skip to content

Templates ​

Templates are a collection of sections configured to provide your store with a consistent look and feel. In the theme editor, you can see which templates are applied to which pages and customize them to adjust the information displayed to your customers.

WARNING

  • Deleting, renaming, or editing theme files can cause your theme to stop working.
  • Always create a backup of your theme before making any changes in the code editor.
  • We’re not responsible for any issues that may occur from editing theme files and cannot assist if something breaks.
  • Use your backup to restore your theme if anything goes wrong.

Edit ​

IMPORTANT

When you edit a template, the changes apply to all pages that use that template.

Example: Adding a newsletter signup form to the default collection template means every collection page using that template will display the signup form.

If needed, follow the steps in Revert template to undo the changes.

Create ​

To display certain pages differently, create a new template based on an existing one. The new template will inherit the same sections, which you can edit without impacting the original template.

  1. From your Shopify admin, go to Online Store β†’ Themes
  2. Click Edit theme
  3. In the Home page dropdown (top-center), select Pages
  4. Click (+) Create template
  5. Enter a name for your new template.
  6. Select the template you want your new template to be based on.
  7. Click Create template

Revert files ​

If you've edited a template (e.g. page) and now all pages show the same content, you can restore the original template.

Code editor ​

IMPORTANT

Create a backup of your theme before making any changes.

  1. From your Shopify admin, go to Online Store β†’ Themes
  2. Locate your current instance of Etheryx, click β€’β€’β€’ and then click Edit code
  3. In the code editor, locate the templates folder, and open it
  4. Scroll through the list until you see the template file that you want to revert
    (e.g. page.json, collection.json, product.json)
  5. Open the file, and scroll down (bottom-left) and open the Timeline tab.
  6. Scroll through the list until you see Original, right-click it, then click Restore contents
  7. Click Save (top-right of the page)

This will reset the template to its original state, fixing any layout issues caused by recent edits.

πŸ–ΌοΈ Screenshot
A browser screenshot

WARNING

If you've updated or duplicated your theme, Shopify won’t retain file history in the Timeline tab for the new version. This is why the Timeline tab may appear empty.

Theme editor ​

If the Timeline tab is empty because you've updated your theme, try these steps instead.

  1. From your Shopify admin, go to Online Store β†’ Themes
  2. Click Edit theme
  3. In the Home page dropdown (top-center), select the page type you want to revert
    (e.g., Pages, Collections, Products)
  4. In the left sidebar, find the Template area you want to revert
  5. Remove all sectionsΒ from the Template area by hovering over each section and clicking theΒ trash icon, or right-clicking and Remove
  6. Repeat until only the main template section remains (it cannot be removed)
  7. Click Save

This will remove all the extra content appearing on all pages and effectively revert the template to its original state.

Rename ​

WARNING

Editing a template file can cause issues with your online store.

IMPORTANT

Create a backup of your theme before making any changes.

IMPORTANT

We’re not responsible for any issues that may occur from editing theme files.

  1. From your Shopify admin, go to Online Store β†’ Themes
  2. Locate your current instance of Etheryx, click β€’β€’β€’ and then click Edit code
  3. In the code editor, locate the templates folder
  4. Scroll through the list until you see the template that you want to rename
  5. Right-click it, then click Rename...
  6. Enter a new template name
  7. Click Save (top-right of the page)

Delete ​

WARNING

Deleting a file is permanent and cannot be undone.

IMPORTANT

Create a backup of your theme before deleting any files.

IMPORTANT

We’re not responsible for any issues that may occur from deleting theme files.

To delete a template, you need to use the code editor.

  1. From your Shopify admin, go to Online Store β†’ Themes
  2. Locate Etheryx, click β€’β€’β€’ and then click Edit code
  3. In the code editor, locate the templates folder
  4. Scroll through the list until you see the template that you want to delete
  5. Right-click it, then click Delete Permanently
  6. In the pop-up that appears, click Delete
  7. Click Save (top-right of the page)

NOTE

If any resources (e.g., pages or products) were assigned to the deleted template, they will automatically use the default template until you assign a different one.

Assign ​

Theme editor ​

  1. From the left bar click Change
  2. Select the page you want to assign the new template to
  3. Click Save

Admin area ​

If the first option for assigning the page fails, try this one instead.

  1. From Shopify admin, go to Online Store β†’ Pages
  2. Open the desired page
  3. Locate the Online store block and select a template from your current theme’s dropdown list to define how the page is displayed
  4. Click Save

Assign in Bulk ​

You can use the Bulk editor to apply a new template to multiple products or collections at once.

  1. From your Shopify admin, go to Products

  2. Select the products you want to edit using one of the following methods:

    • Select individual products: Click the checkbox next to each product.
    • Select a range of products: Click the first product, hold the Shift key, then click the last product. This selects all products in between.
    • Select all products on the current page: Click the checkbox at the top of the product list.
    • Select all products in your store: Click the checkbox at the top, then click Select all in this store.
  3. Click Bulk edit

  4. In the Bulk editor, click the Columns drop-down menu and select Template from the General section.

  5. Click the first field in the Template column, then hold the Shift key and click the last field in that column. A blue highlight will appear around the selected items.

  6. Click the first selected field, choose the new template from the drop-down menu,

  7. Click Save

Access unpublished templates ​

Shopify limits the templates in the admin to those included in your published theme. Often times you’ll require access to templates in an unpublished theme but you are not ready to publish the new theme to unlock them. To address this, we suggest completing this workaround.

WARNING

Before continuing with this guide, make sure you have purchased Etheryx

Step β‘  - Confirm template name ​

  1. From your Shopify admin, go to Online Store β†’ Themes
  2. Locate Etheryx, then click β€’β€’β€’ β†’ Edit code
  3. Under Templates, find the template you want to make accessible
    (e.g., page.about.json)

    NOTE

    No changes are needed here; simply note the template name for the next step.


Step β‘‘ - Create custom template in published theme ​

  1. From your Shopify admin, go to Online Store β†’ Themes

  2. Next to your published theme (e.g., Horizon, Dawn), click β€’β€’β€’ β†’ Edit code

  3. In the left sidebar, open the Templates folder, then click the New file... icon (at the top)

    WARNING

    Make sure you’re inside the Templates folder, otherwise the editor will show FileSaveError: Theme file '...' is invalid. error

  4. For File name, enter the custom template name you noted in Step β‘ 
    (e.g. page.about.json)

    IMPORTANT

    The name must exactly match the template name from the unpublished theme.

  5. Click Save (top-right of the page)


Step β‘’ - Confirm template is accessible ​

  1. From your Shopify admin, go to Online Store β†’ Pages
  2. Open the page you want to associate with the template
    (e.g. About us)
  3. On the right side, in the Theme template dropdown, select the custom template name (e.g. about)
  4. Click Save