✦ Installation Guide

How to install Variant Image Manager?

Follow these steps to install and configure Variant Image Manager for your Shopify store.

1️⃣ Step 1: Install the App

1
Visit the Shopify App Store

Go to the Variant Image Manager listing in the Shopify App Store.

2
Click "Add app"

Click the green "Add app" button to begin installation.

3
Authorize the App

Review the permissions and click "Install app" to authorize Variant Image Manager to access your store.

ℹ️

Permissions Required

  • Read and write products
  • Read and write content (for images)

2️⃣ Step 2: Sync Your Products

1
Open the App

After installation, you'll be redirected to the Variant Image Manager dashboard in your Shopify admin.

2
Click "Sync All from Shopify"

Click the "Sync All from Shopify" button to import all your products with variants.

💡

Note: Only products with 2 or more variants will be shown. Single-variant products don't need variant-specific images.

3
Wait for Sync to Complete

The sync process will import all your products and their variants. This may take a few moments depending on your catalog size.

3️⃣ Step 3: Assign Variant Images

1
Select a Product

Click "Manage Variants" on any product to configure its variant images.

2
Drag Images to Variants

You'll see all product images at the top and variant tabs below. Simply drag images from the image pool to the variant you want them to appear for.

👆

Pro Tip: You can drag images within a variant to reorder them. The first image will be the main image for that variant.

3
Add Variant Descriptions (Optional)

Add custom descriptions for each variant to highlight specific features or details.

4
Save Changes

Click "Save All Changes" to save your variant configuration.

4️⃣ Step 4: Add to Your Storefront

1
Open Theme Editor

Go to Online Store → Themes → Customize in your Shopify admin.

2
Navigate to Product Page

In the theme editor, navigate to any product page template.

3
Add the App Block

Click "Add block" or "Add app block" and select "Variant Image Gallery" from the Apps section.

⚠️

Important: The app block should be added to your product page template. It works invisibly in the background to update your existing product images.

4
Save and Publish

Click "Save" in the theme editor. Your variant gallery is now active!

5️⃣ Step 5: Test Your Setup

1
Visit a Product Page

Open a product page on your storefront that has variant images configured.

2
Select Different Variants

Click on different variant options (colors, sizes, etc.) and watch the images update automatically!

What You Should See:

  • Product images update to show only the selected variant's images
  • Variant-specific description appears above product description (if configured)
  • Extra images are hidden automatically

🔧 Troubleshooting

🤔 Images not updating when selecting variants?
  • Make sure you've added the "Variant Image Gallery" app block to your product page in the theme editor
  • Verify that you've assigned images to variants in the app admin
  • Clear your browser cache and try again
🤔 Products not showing in the app?
  • Only products with 2 or more variants are shown
  • Click "Sync All from Shopify" to refresh your product list
  • Make sure your products have variants in Shopify
📬 Need more help?

Contact our support team at apps@task19.com and we'll be happy to help!

🚀

Ready to get started?

Install Variant Image Manager from the Shopify App Store. Free plan available with no setup required. Add to Shopify