# Productgroups *This describes* [*Product Group schema version 1.1*](https://mbintegrationdataprod.blob.core.windows.net/schemas/productGroups-v1.1.xsd)*.* Product groups is used for creating a hierarchy of products. It makes it easier for the users to do the search by brand or by product type. Much like pricelists, product groups are not inherited along the customer tree automatically, only stores that subscribe to the the product groups can see them. ## Usage ### Subscriptions Managing the product group subscriptions cannot currently be done through the API, it needs to be done through Mediablob. Subscribing to product groups is all or nothing, the store either has access to the full set of product groups, or none at all. ### Function call Use the function call *UploadProductGroupsXml* to upload your product group xml. ### Structure The product groups are a hierarchy where each group can contain a number of subgroups, which in turn can have their own subgroups, etc. Each group must have its own unique ID. Shoppa places no particular restrictions on these ID:s, so we recommend that you mirror existing ID:s in whichever system you are using. Each group must also contain at least one text element, specifiying the name of the group. The group names can be specified by language, so that different users can have different group names, but bear in mind that the group structure and its contents will be the same. The full definition of the product groups is done in two parts: first the structure is defined as per above, and then the products are assigned to their groups using the groups ID. Note that a product can belong to multiple groups. ```markup ``` ### Changing the structure The group structure cannot be edited. If a change is required you need to send the entire structure again. Note that products can still be added to groups without having to resend the entire structure. ## Examples ### Basic product groups ```markup ``` ### Nested groups with multiple languages ```markup ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://shoppa.gitbook.io/knowledge-hub/api-documentation/xml-structure/productgroups.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.