Woo Variation Image Auto Mapper Documentation

Everything you need to install, configure and master the plugin.

Quick Start

  • 1 Install plugin
  • 2 Add attribute slugs
  • 3Create variable product
  • 4Add unique word
  • 5Upload images
  • 6Generate variations
  • 7 Check report

Correct image name structure

unique-wordattribute-term-slug-product-name.jpg

Example

premiumblack-hoodie.jpg

premium — unique product word

black — attribute term slug

hoodie — product name for identification

Important: The attribute term slug in the image name must exactly match the WooCommerce variation term slug. Find it under Products → Attributes → Attribute Terms → Slug.

Guides

Go to plugin Settings → Attribute Slugs and add one or more WooCommerce attribute slugs. Free Mode allows one slug; Premium is unlimited.

Open your variable product. In the ‘Auto Mapper’ panel, enter a unique short word for that product (letters, numbers, hyphens). This word becomes the first part of your image filenames.

Upload images to WooCommerce in any order. Names must follow unique-word-term-slug-product-name.jpg exactly. Use only lowercase letters and hyphens.

Use ‘Create variations from all attributes’ from the WooCommerce variations dropdown. The plugin hooks in automatically and starts mapping.

Open Plugin Dashboard → Mapping Report. You’ll see total / completed / failed counts and the latest batch status.

If the same filename already exists, the plugin alerts you. Choose ‘Skip’ to ignore the new upload or ‘Upload Anyway’ to keep both copies.

Premium: open Manage Unique Words to view, search, edit or delete any mapping word across your store.

Premium: Settings → Export downloads a JSON file. Import the file on a staging or new site to copy all attribute slugs and configuration.

Settings → Delete My Data. Removes all plugin tables and options. This is manual only — uninstalling alone keeps data intact.

Premium: Settings → Permissions assigns capabilities (view, edit, manage) to each WordPress role.

After purchase, paste your license key in Settings → License and click Activate. The site is bound to that license until deactivated.

Troubleshooting

Image not mapping — check filename has lowercase letters and matches term slug exactly.

Wrong image mapped — your unique word may be shared across products. Make it unique.

Report says 'set' but UI not visible — refresh WooCommerce variations panel; cached data updates after batch finishes.

Duplicate upload popup — choose Skip or Upload Anyway depending on intent.

Variation search not finding result — confirm you're searching the failed variation ID, not the product ID.

Free mode limitations — upgrade to Premium for failed details, multi-attribute and developer mode.

Scroll to Top