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
Get a variant groupManagement API
List all app variant groupsManagement API
List variant groupsManagement API

Create or attach

Update or repair

OperationAPI
Reorder variant group imagesManagement API
Update a variant groupManagement 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 | | --- | --- | | [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 | | [List variant groups](/reference/variant-groups/list-variant-groups) | Management API | ## Create or attach | Operation | API | | --- | --- | | [Add a tag to a variant group](/reference/variant-groups/add-a-tag-to-a-variant-group) | Management API | | [Create a variant group](/reference/variant-groups/create-a-variant-group) | Management API | | [Set variant group channel status](/reference/variant-groups/set-variant-group-channel-status) | Management API | | [Set variant group images](/reference/variant-groups/set-variant-group-images) | Management API | | [Set variant group videos](/reference/variant-groups/set-variant-group-videos) | Management API | ## Update or repair | Operation | API | | --- | --- | | [Reorder variant group images](/reference/variant-groups/reorder-variant-group-images) | Management API | | [Update a variant group](/reference/variant-groups/update-a-variant-group) | 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 |