# Attribute Groups

Attribute Groups allow fine-grained access management to a subset of Attributes of a [Product](https://docs.commercetools.com/api/projects/products.md).

Attribute Groups allow you to define a set of referenced [Attribute Definitions](https://docs.commercetools.com/api/projects/productTypes.md#attributedefinition) for the purpose of giving one or more dedicated teams access to edit Attribute values in Products and [Product Variants](https://docs.commercetools.com/api/projects/products.md#productvariant) for those Attributes in the Merchant Center. Depending on the use case, you can grant editing permission to all Attributes, only Attributes within selected Attribute groups, or none. Only teams with editing permissions can edit Attributes.

Regardless of the Product Type, Attributes are referenced by their name as it appears in their [Attribute Definition](https://docs.commercetools.com/api/projects/productTypes.md#attributedefinition). That is, if multiple [Product Types](https://docs.commercetools.com/api/projects/productTypes.md) define an Attribute with the same name, teams with access to that Attribute can edit Attribute values for [Products](https://docs.commercetools.com/api/projects/products.md) of any of those [Product Types](https://docs.commercetools.com/api/projects/productTypes.md).

A maximum number of 100 Attribute Groups can be created per Project.

Learn more about Attribute Groups in our self-paced Attribute types and Attribute Groups module.

## Representations

#### AttributeGroup

See API type definition [AttributeGroup](https://docs.commercetools.com/api/projects/attribute-groups.md?urn=ctp%3Aapi%3Atype%3AAttributeGroup).

#### AttributeReference

See API type definition [AttributeReference](https://docs.commercetools.com/api/projects/attribute-groups.md?urn=ctp%3Aapi%3Atype%3AAttributeReference).

#### AttributeGroupDraft

See API type definition [AttributeGroupDraft](https://docs.commercetools.com/api/projects/attribute-groups.md?urn=ctp%3Aapi%3Atype%3AAttributeGroupDraft).

#### AttributeGroupPagedQueryResponse

See API type definition [AttributeGroupPagedQueryResponse](https://docs.commercetools.com/api/projects/attribute-groups.md?urn=ctp%3Aapi%3Atype%3AAttributeGroupPagedQueryResponse).

#### AttributeGroupReference

See API type definition [AttributeGroupReference](https://docs.commercetools.com/api/projects/attribute-groups.md?urn=ctp%3Aapi%3Atype%3AAttributeGroupReference).

#### AttributeGroupResourceIdentifier

See API type definition [AttributeGroupResourceIdentifier](https://docs.commercetools.com/api/projects/attribute-groups.md?urn=ctp%3Aapi%3Atype%3AAttributeGroupResourceIdentifier).

## Get AttributeGroup

### Get AttributeGroup by ID

See API endpoint definition [GET /\{projectKey}/attribute-groups/\{id}](https://docs.commercetools.com/api/projects/attribute-groups.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fattribute-groups%2F%7Bid%7D%3AGET).

### Get AttributeGroup by Key

See API endpoint definition [GET /\{projectKey}/attribute-groups/key=\{key}](https://docs.commercetools.com/api/projects/attribute-groups.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fattribute-groups%2Fkey%3D%7Bkey%7D%3AGET).

## Query AttributeGroups

See API endpoint definition [GET /\{projectKey}/attribute-groups](https://docs.commercetools.com/api/projects/attribute-groups.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fattribute-groups%3AGET).

## Check if AttributeGroup exists

### Check if AttributeGroup exists by ID

See API endpoint definition [HEAD /\{projectKey}/attribute-groups/\{id}](https://docs.commercetools.com/api/projects/attribute-groups.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fattribute-groups%2F%7Bid%7D%3AHEAD).

### Check if AttributeGroup exists by Key

See API endpoint definition [HEAD /\{projectKey}/attribute-groups/key=\{key}](https://docs.commercetools.com/api/projects/attribute-groups.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fattribute-groups%2Fkey%3D%7Bkey%7D%3AHEAD).

### Check if AttributeGroup exists by Query Predicate

See API endpoint definition [HEAD /\{projectKey}/attribute-groups](https://docs.commercetools.com/api/projects/attribute-groups.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fattribute-groups%3AHEAD).

## Create AttributeGroup

See API endpoint definition [POST /\{projectKey}/attribute-groups](https://docs.commercetools.com/api/projects/attribute-groups.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fattribute-groups%3APOST).

## Update AttributeGroup

### Update AttributeGroup by ID

See API endpoint definition [POST /\{projectKey}/attribute-groups/\{id}](https://docs.commercetools.com/api/projects/attribute-groups.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fattribute-groups%2F%7Bid%7D%3APOST).

### Update AttributeGroup by Key

See API endpoint definition [POST /\{projectKey}/attribute-groups/key=\{key}](https://docs.commercetools.com/api/projects/attribute-groups.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fattribute-groups%2Fkey%3D%7Bkey%7D%3APOST).

## Update actions

#### Set Key

See API type definition [AttributeGroupSetKeyAction](https://docs.commercetools.com/api/projects/attribute-groups.md?urn=ctp%3Aapi%3Atype%3AAttributeGroupSetKeyAction).

#### Change Name

See API type definition [AttributeGroupChangeNameAction](https://docs.commercetools.com/api/projects/attribute-groups.md?urn=ctp%3Aapi%3Atype%3AAttributeGroupChangeNameAction).

#### Set Description

See API type definition [AttributeGroupSetDescriptionAction](https://docs.commercetools.com/api/projects/attribute-groups.md?urn=ctp%3Aapi%3Atype%3AAttributeGroupSetDescriptionAction).

#### Add Attribute

See API type definition [AttributeGroupAddAttributeAction](https://docs.commercetools.com/api/projects/attribute-groups.md?urn=ctp%3Aapi%3Atype%3AAttributeGroupAddAttributeAction).

#### Remove Attribute

See API type definition [AttributeGroupRemoveAttributeAction](https://docs.commercetools.com/api/projects/attribute-groups.md?urn=ctp%3Aapi%3Atype%3AAttributeGroupRemoveAttributeAction).

#### Set Attributes

See API type definition [AttributeGroupSetAttributesAction](https://docs.commercetools.com/api/projects/attribute-groups.md?urn=ctp%3Aapi%3Atype%3AAttributeGroupSetAttributesAction).

## Delete AttributeGroup

### Delete AttributeGroup by ID

See API endpoint definition [DELETE /\{projectKey}/attribute-groups/\{id}](https://docs.commercetools.com/api/projects/attribute-groups.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fattribute-groups%2F%7Bid%7D%3ADELETE).

### Delete AttributeGroup by Key

See API endpoint definition [DELETE /\{projectKey}/attribute-groups/key=\{key}](https://docs.commercetools.com/api/projects/attribute-groups.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fattribute-groups%2Fkey%3D%7Bkey%7D%3ADELETE).

## Related pages

- [Section overview page](https://docs.commercetools.com/api.md)
- [Previous page: Product Types](https://docs.commercetools.com/api/projects/productTypes.md)
- [Next page: Products](https://docs.commercetools.com/api/projects/products.md)