Check 1: Video Gallery Block Added
The most common reason videos don’t display is the app block isn’t added to your theme.
How to check:
Go to Online Store > Themes > Customize
Navigate to the page where you want videos
Look for a Video Gallery block in the page sections
If missing, click Add section or Add block
Select Video Gallery from the Apps list
Click Save
Without the Video Gallery block added to your page, there’s nothing to display the videos.
Check 2: Gallery ID Entered in Block
Each Video Gallery block needs the Gallery ID to know which gallery to display.
How to check:
In the theme editor, click on your Video Gallery block
Look for the Gallery ID setting
Ensure a Gallery ID is entered (copy it from your gallery page in the app)
If empty, paste the Gallery ID from the app
Save changes
A block without a Gallery ID shows nothing.
Check 3: Gallery Has Videos
Even with the correct gallery selected, the gallery needs videos to display.
How to check:
In the app, go to Galleries
Click on the gallery being used
Check if it has videos listed
If the gallery is empty:
For auto-sync galleries: Verify the source has videos and run a manual sync
For manual galleries: Click Select Videos and add videos
Check 4: Videos Synced from Source
Your gallery may be configured correctly but no videos have synced yet.
How to check:
Go to Sources in the app
Click on your source (channel or playlist)
Check the video count
If the source shows no videos:
Click Sync to manually fetch videos
Verify your YouTube account is connected
Check that the channel has public videos
Check 5: YouTube Account Connected
Videos can’t sync without a connected YouTube account.
How to check:
Go to the app dashboard
Check if your YouTube channel is shown as connected
If not connected, click Connect YouTube and complete the setup
Check 6: Theme Compatibility
Some older themes may have limited support for app blocks.
How to check:
In theme editor, ensure the Video Gallery block is placed in a supported section
Try adding the block to a different section or page
Most Online Store 2.0 themes support app blocks
For vintage themes: If your theme doesn’t support app blocks, you may need to upgrade to a newer theme or contact support for guidance.
Check 7: Browser Cache
Sometimes cached files prevent new content from displaying.
How to fix:
Clear your browser cache
Try viewing in an incognito/private window
Try a different browser
Check 8: Preview vs Live Store
Make sure you’re testing on the correct version:
Theme preview — Shows unpublished changes
Live store — Shows what customers see
If videos show in preview but not on live store, you may need to publish your theme changes.
Quick Troubleshooting Checklist
Video Gallery block added to theme page
Gallery ID entered in block settings
Gallery contains videos
Source has synced videos
YouTube account is connected
Theme changes are saved/published
Browser cache is cleared
Still Not Working?
If you’ve checked everything above and videos still don’t display:
Check browser console — Right-click > Inspect > Console tab. Look for JavaScript errors.
Try a different page — Add a gallery block to a simple page to isolate the issue.
Contact support — Provide your store URL and describe what you’ve tried.
What’s Next
Connection Issues - Fix YouTube connection problems
Sync Issues - Troubleshoot video syncing
Display Settings - Customize gallery appearance
