If you’ve added the Image Gallery block to a page but nothing appears on your storefront, the cause is almost always one of a handful of small mistakes. The block is designed to fail quietly on the storefront (no error banners or broken layouts) which is great for visitors but can make troubleshooting feel like guesswork. Here’s a checklist to run through.
Check the Gallery ID
By far the most common cause is a missing or mistyped Gallery ID:
Open the theme editor and click the Image Gallery block.
Look at the Gallery ID setting - It should look like
gal_abc123. If it’s empty, paste in your Gallery ID and save.Copy fresh from the app - Open the gallery, click Install to Theme, and use the copy button next to the Gallery ID (the Installation page lists every gallery’s ID too). Pasting a fresh copy rules out typos.
Make sure the ID matches a real gallery - If you’ve deleted the gallery, the block will show nothing.
Check You Have Images in the Gallery
A gallery with no images won’t render anything on the storefront:
Open the gallery in the app.
Verify there’s at least one image - If the gallery is empty, upload a few images, pick them from your library, or import a collection.
Click Save after adding images - Newly dropped or picked images sit on the canvas unsaved until you use the save bar or the Save button, and unsaved images never reach the storefront.
Check the Block Was Saved in the Theme Editor
Adding a block isn’t enough — the theme editor has to save the change:
Open the theme editor and look at the top right for the Save button.
If it’s highlighted, you have unsaved changes. Click Save.
Reload your storefront with a hard refresh (Cmd+Shift+R on Mac, Ctrl+Shift+R on Windows).
Check the Right Theme
If you have multiple themes (live, drafts, previews), the block has to be in the live theme to appear on your public storefront:
Go to Online Store > Themes in your admin.
Note which theme is marked “Current theme” — that’s your live theme.
Make sure the Image Gallery block is in that theme, not in a draft.
When you click Install to Theme in the app, the theme picker shows which one is “current” so you can target the right one.
Check the Theme Editor Preview
The theme editor itself shows a helpful placeholder when something is missing:
Empty gallery ID - Shows “Enter a Gallery ID in the block settings.”
No images found - Shows “Add images in the app.”
If you see either message in the editor, fix the issue there and save.
Still Not Working
If everything above checks out and the gallery still doesn’t show, try:
A hard refresh in an incognito window - This rules out browser cache.
Checking another page with the same block - Helps you tell if the issue is global or page-specific.
Removing and re-adding the block - As a last resort, delete the block, save the theme, then add it back with a fresh Gallery ID.