Skip to content
Maison

Search the documentation

Type a setting, a section or a question.

Guides

Editing code

Before you touch the theme files: precautions, support limits, and alternatives.

On this page

Do you really need to?

Most needs can be handled without code:

NeedNo-code solution
Change fixed text ("Complimentary delivery")Edit default theme content. See Languages and currencies.
Insert a widget or HTML snippetCustom Liquid section or block.
Show different content for each productConnect a block to a metafield (dynamic source).
A different layout for some productsAn alternate template.
An extra feature (reviews, loyalty, and so on)An app block or app embed.

Open the code editor

In Online StoreThemes, open the theme's ... menu, then click Edit code. Files follow Shopify's standard structure: layout, templates, sections, blocks, snippets, assets, config, and locales.

A few pointers specific to Maison:

  • Style variables (colors, spacing, sizes) are calculated in snippets/css-variables.liquid from the theme settings. Editing a value by hand breaks the link with the settings, so use the settings instead.
  • Each component's styles and script are in its own file (section or block), not in a global stylesheet.
  • All buttons go through snippets/button.liquid, and drawers through snippets/drawer.liquid.
  • Storefront text is in locales/*.json, in English and French.

What support covers

For custom work, hire a Shopify Partner: the Shopify Partner Directory lists vetted developers and agencies.

Keeping your changes when you update

Code changes aren't carried over when you update the theme. Note each change (file, reason, code snippet) so you can reapply it, and prefer no-code solutions when they exist.

Was this page helpful?

Maison 1.0.0