eekaam.docs

Guides

Editing your theme


Editing your theme

Online Store → Themes → Customise opens the theme editor. It is a live preview of your storefront with a settings panel beside it: change something on the left, see it on the right, and nothing reaches shoppers until you save.

Sections and blocks

A page is built from sections stacked down it — a hero, a featured collection, a testimonial row. Each section has its own settings, and most hold blocks: the individual slides in a slideshow, the links in a footer menu.

You can add, remove and drag sections into a different order. Which sections are available depends on the theme — a theme declares them, so a theme built for fashion offers different ones than a theme built for electronics.

Theme settings

The settings panel covers the whole theme rather than one page: colours, typography, button shapes, spacing, the logo, social links, and the cart's behaviour. These apply everywhere, which is what keeps a storefront looking like one shop.

Editing safely

The theme you are editing is not necessarily the live one. Duplicate the live theme, edit the copy, and publish it when you are happy — your shop keeps running on the old one until you do.

Online Store → Themes lists every theme on the store with a Publish action on each.

Editing the code

Themes are Liquid, and the file editor is there if you want it. Two cautions worth stating plainly:

  • Edit a duplicate, never the live theme. A Liquid syntax error takes the storefront down.
  • Code edits are lost when you update a theme bought from the theme store, because the update replaces the files. If you need a change to survive updates, keep it in a section setting rather than in the code.

If you are building a theme rather than adjusting one, work locally with the CLI instead — eekaam theme dev gives you hot reload and a real editor. See Eekaam CLI and Theme requirements.

Preview and share

The editor previews against your real products. To show a work-in-progress to someone without an Eekaam account, generate a share link:

eekaam theme share --expires 7

Updated 15 September 2026