Variant Groups API reference

Reference map for Variant Groups API operations.

Updated
Apr 26, 2026

Variant Groups

Use this reference map to choose the operation group before opening an endpoint page for exact request and response details.

Use Variant Groups when the job is about a product-level grouping of related purchasable variants, not the whole product record and not one exact variant.

The Management API contract exposes product-scoped variant-group operations for listing, creating, updating, deleting, media assignment, media reordering, tag relationships, channel status, and app-wide filtered listing.

Start with product-scoped reads when you already know the product. Use the app-wide list when you need to find variant groups across the app by tag or attribute filters. Use the media, tag, and channel-status operations only after the variant group exists.

For the plain-language model, see Variant groups.

Read and inspect

OperationAPI
List variant groupsManagement API
Get a variant groupManagement API
List all app variant groupsManagement API

Create or attach

Update or repair

OperationAPI
Update a variant groupManagement API
Reorder variant group imagesManagement API

Remove or deactivate

OperationAPI
Delete a variant groupManagement API
Remove a tag from a variant groupManagement API

Bulk operations

Variant Groups API reference

# Variant Groups Use this reference map to choose the operation group before opening an endpoint page for exact request and response details. Use Variant Groups when the job is about a product-level grouping of related purchasable variants, not the whole product record and not one exact variant. The Management API contract exposes product-scoped variant-group operations for listing, creating, updating, deleting, media assignment, media reordering, tag relationships, channel status, and app-wide filtered listing. Start with product-scoped reads when you already know the product. Use the app-wide list when you need to find variant groups across the app by tag or attribute filters. Use the media, tag, and channel-status operations only after the variant group exists. For the plain-language model, see [Variant groups](/start/concepts/variant-groups).

14 operations grouped by the job they support.

## Read and inspect | Operation | API | | --- | --- | | [List variant groups](/reference/variant-groups/list-variant-groups) | Management API | | [Get a variant group](/reference/variant-groups/get-a-variant-group) | Management API | | [List all app variant groups](/reference/variant-groups/list-all-app-variant-groups) | Management API | ## Create or attach | Operation | API | | --- | --- | | [Set variant group channel status](/reference/variant-groups/set-variant-group-channel-status) | Management API | | [Create a variant group](/reference/variant-groups/create-a-variant-group) | Management API | | [Set variant group images](/reference/variant-groups/set-variant-group-images) | Management API | | [Add a tag to a variant group](/reference/variant-groups/add-a-tag-to-a-variant-group) | Management API | | [Set variant group videos](/reference/variant-groups/set-variant-group-videos) | Management API | ## Update or repair | Operation | API | | --- | --- | | [Update a variant group](/reference/variant-groups/update-a-variant-group) | Management API | | [Reorder variant group images](/reference/variant-groups/reorder-variant-group-images) | Management API | ## Remove or deactivate | Operation | API | | --- | --- | | [Delete a variant group](/reference/variant-groups/delete-a-variant-group) | Management API | | [Remove a tag from a variant group](/reference/variant-groups/remove-a-tag-from-a-variant-group) | Management API | ## Bulk operations | Operation | API | | --- | --- | | [Bulk Add Variant Groups to Tags](/reference/variant-groups/bulk-add-variant-groups-to-tags) | Management API | | [Bulk Remove Variant Groups from Tags](/reference/variant-groups/bulk-remove-variant-groups-from-tags) | Management API |