# Products *NOTE: This describes* [*schema version 1.7*](https://mbintegrationdataprod.blob.core.windows.net/schemas/mediablob-v1.7.xsd)*.* A product has codes, texts and pictures. The texts and pictures can be defined for multiple languages. For each product a set of complement products can also be defined. *Note that all used languageCodes must be registered on the account used to upload the information to Mediablob. Please check your account details with your Shoppa representative if you are unsure.* Lets build a product from scratch and see how different requiements evolve its xml definition. ## A basic product Lets say our customerId is *1143* and we have a product with only some basic information: * **brand**: Orrefors * **name**: Champagneglas * **sku**: 65467-14 * **ean code**: 123456789012 This corresponding xml format is: ```markup ``` A product must always have at least one `text` section. Brand and name are required for new products. In the example above the product is described in the Swedish language. ## Extending the product information We extend the product with additional sales arguments and a unit for prices: * **short sales argument**: Exklusivt tvåpack. En perfekt bröllopspresent. * **long sales argument**: Efva Attling är en juveldesigner som har använt sin rika erfarenhet och expertis för att skapa glaskonst. Hennes tredje glas är ett maskulint martiniglas med en silverring. * **unit**: st The xml for describing the product now becomes: ```markup Exklusivt tvåpack & en perfekt bröllopspresent. Efva Attling är en juveldesigner som har använt sin rika erfarenhet och expertis för att skapa glaskonst. Hennes tredje glas är ett maskulint martiniglas med en silverring. st ``` *To protect content against xml formatting constraints, the* `&` *character is xml encoded. This follows the xml specification and must be used for any content.* ## Additional languages We decide to support English too. The xml gets extended with an additional `` section. We also start the product with a generic language text `xx` with generic text for all languages unless overridden. *Even without actual such texts, we recommend always including a row for xx to prevent duplicate products in the future.* ```markup Exklusivt tvåpack & en perfekt bröllopspresent. Efva Attling är en juveldesigner som har använt sin rika erfarenhet och expertis för att skapa glaskonst. Hennes tredje glas är ett maskulint martiniglas med en silverring. st Exclusive Twin-pack & the perfect wedding present. Efva Attling is a designer of jewellery who has now brought her considerable experience and skills to the creation of glass. The third glass of the collection is a more masculine martini glass whose silver ring, though slightly sterner than its cousins, expresses the same warm sentiments. item ``` ## Extra codes In some cases an article can have multiple codes of the same code type. For example, multiple EAN codes from different suppliers that are bound to the same article.\ In this case you can add on extra codes to the code field so that you can search for either one of them to get a match on the product. ``` 123456789013 123456789014 123456789015 Exklusivt tvåpack & en perfekt bröllopspresent. Efva Attling är en juveldesigner som har använt sin rika erfarenhet och expertis för att skapa glaskonst. Hennes tredje glas är ett maskulint martiniglas med en silverring. st Exclusive Twin-pack & the perfect wedding present. Efva Attling is a designer of jewellery who has now brought her considerable experience and skills to the creation of glass. The third glass of the collection is a more masculine martini glass whose silver ring, though slightly sterner than its cousins, expresses the same warm sentiments. item ``` ## Picture support Finally, we add pictures to the swedish brand and productName fields. English users do not get to see any pictures for now. ```markup Exklusivt tvåpack & en perfekt bröllopspresent. Efva Attling är en juveldesigner som har använt sin rika erfarenhet och expertis för att skapa glaskonst. Hennes tredje glas är ett maskulint martiniglas med en silverring. st Exclusive Twin-pack & the perfect wedding present. Efva Attling is a designer of jewellery who has now brought her considerable experience and skills to the creation of glass. The third glass of the collection is a more masculine martini glass whose silver ring, though slightly sterner than its cousins, expresses the same warm sentiments. item ``` As you can see, the pictures are referenced by a hashCode. What hashCode to use will be described in detail in the Pictures section. *Pictures require a* `countryCode`*. This is a legacy construct and is easily created by lowercasing the last two characters of the languageCode.* ### Reference a picture by its md5 hash The hashCode returned from the picture uploader is based on md5, but formatted as a guid. The difference is big or little endianess. If you prefer to reference the picture by its md5 code, you can use the `md5` attribute instead: ```markup ``` ### Reference a picture with a public uri Instead of referencing an image by hashCode or md5, you can provide a public uri from where Mediablob can download the picture for you. Mediablob will only use the same uri once, so you must ensure the uri is unique for each picture. Avoid using this scheme unless you are using a picture database that ensure unique uri's per picture. ```markup ``` *In the sample above, Mediblob would keep using the original downloaded picture even if the content of the uri changes.* --- # 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/product.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.