Debut theme: Add a lightbox zoom to product page images (mobile & desktop)

Debut's built-in zoom is hover only and desktop only. On a phone you get pinch-to-zoom, which is a poor way to look at a product. This snippet adds a lightbox zoom. Tap or click the image and it opens large. No app. Last tested on Debut in 2026.

You add one snippet, include it in theme.liquid, then paste a small block into Theme settings. Apps that do the same job usually load after the page and cost a monthly fee. This one is copy/paste.

This is Debut only. If you're on Dawn, the zoom fix is a different tutorial.

Live preview: Debut Zoom demo.

Download a backup of the theme first. If something breaks you can roll back in about 10 seconds.

What you'll paste

The gist has two files. You need both.

Snippet file name:

ezfy-zoom.liquid

Theme settings file:

config/settings_schema.json

How to add the snippet

1. From your Shopify admin, go to Online Store > Themes.
2. Find Debut, click the 3 dots > Edit code.
3. Open the Snippets folder and click Add a new snippet. Name it exactly ezfy-zoom.

   

4. Copy the ezfy-debut-zoom.liquid file from this gist, paste it into the new snippet and save:

   

How to load it on product pages

1. Open theme.liquid.
2. Search for:

   </body>

3. Paste this line before that tag, then save:

   {% include 'ezfy-zoom' %}

   

How to add the Theme settings

The second file in the gist is a JSON fragment. It is not a full settings_schema.json. You paste it into the existing file, not over it.

1. Copy the ezfy-debut-zoom-settings-schema.json file from the gist.
2. In Edit code, open config/settings_schema.json.
3. Scroll to the bottom. Paste the fragment before the last line, after the last }. The file must still end with ].

   

4. Save.

How to customize it

1. From Online Store > Themes, click Customize on Debut.

   

2. Open Theme settings > EZFY Product Image Zoom.

   

3. Turn the lightbox on, pick click vs icon on desktop and save. Preview on the live product page, not only the editor.

If you get a settings_schema error

You pasted at the very bottom. The last character in that file has to be ]. Paste on the second last line, after the }.

This snippet is Debut. It will not work on Dawn.

If you get stuck, tell me whether the error is in settings_schema.json or the snippet file. That usually solves it.