No Gallery ID Set
Symptom: The Video Gallery block shows “Select a Video Gallery” or appears empty.
Cause: The block doesn’t know which gallery to display.
Solution: 1. Open your theme editor (Online Store > Themes > Customize) 2. Navigate to the page with the Video Gallery block 3. Click on the Video Gallery block to select it 4. In the block settings, find the Gallery ID field 5. Enter your gallery ID (e.g., gal_abc123) 6. Click Save
Finding your Gallery ID: Go to Galleries in the app, click on your gallery, and copy the Gallery ID shown on the page.
Gallery Has No Videos
Symptom: The block shows “No Videos in Gallery” message.
Cause: The selected gallery is empty.
Solutions:
Check the gallery in the app:
Go to Galleries and click on the gallery
Verify that videos are listed
Sync your source:
Go to Sources and click on your channel/playlist
Click the Sync button
Wait for sync to complete
Check the gallery again
For manual galleries:
Edit the gallery
Click Select Videos
Choose which videos to include
Save the gallery
App Not Activated in Theme
Symptom: The Video Gallery block doesn’t appear in the theme editor, or blocks don’t render on the storefront.
Cause: The app embed is not enabled in your theme.
Solution: 1. Open your theme editor 2. Click Theme settings (gear icon) in the sidebar 3. Click App embeds 4. Find YouTube Gallery in the list 5. Toggle it ON 6. Click Save
Changed themes recently? You need to activate the app embed in each theme separately. If you switched to a new theme, repeat the activation steps.
Theme Compatibility
Symptom: The block appears but videos don’t load or display incorrectly.
Possible causes: - Theme JavaScript conflicts - Custom CSS overriding gallery styles - Older theme version
Solutions:
Test in a different browser:
Try Chrome, Firefox, or Safari
Disable browser extensions that might block scripts
Check for JavaScript errors:
Open browser Developer Tools (F12 or right-click > Inspect)
Go to the Console tab
Look for red error messages related to YouTube Gallery
Check theme CSS conflicts:
Inspect the gallery element
Look for CSS rules overriding the gallery styles
Add custom CSS to fix conflicts if needed
Update your theme:
Some older themes may have compatibility issues
Check for theme updates in your Shopify admin
Debug Information
When the gallery is empty, expand the Debug Info section in the theme editor to see: - Gallery ID being used - Whether the gallery was found - Number of videos in the gallery - Any error messages
This information helps identify the root cause of display issues.
Still Not Working?
If none of these solutions work: 1. Note down your Gallery ID 2. Check the Debug Info section 3. Contact support with these details