Home

Style (parent) element

Product ID: 1001

Name: V-neck T-Shirt

Color: N/A (because this is Style level)

Color (child) variant element

Product ID: 1001-01

Name: V-neck T-Shirt

Color: Red

Parent Product ID: 1001

Color (child) variant element

Product ID: 1001-02

Name: V-neck T-Shirt

Color: Blue

Parent Product ID: 1001

Color (child) variant element

Product ID: 1001-03

Name: V-neck T-Shirt

Color: Green

Parent Product ID: 1001

Size level object / elements should not be considered <Product> as there is no use case for size specific products within Moderation + end-user UGC shopping experience. You should only include size-specific items as <Product> elements If you wish to moderate and showcase size specific products on your site..

Regarding "size" specific product information:

Product feed hierarchy visualization

Click on the flowchart element to explore the example XML output.

<?xml version="1.0" encoding="UTF-8"?>
<Feed>
    <Categories>
    ...
    </Categories>
    <Products>
            ...
            <Product>
                <Name>V-neck T-Shirt</Name>
                <ProductUniqueID>10001-01</ProductUniqueID>
                <ProductUrl>...</ProductUrl>
                <ImageUrl>...</ImageUrl>
                <Description>...</Description>
                <CategoryID>cat-123</CategoryID>
                <UPCs>
                    <UPC>001122334455</UPC>
                    <UPC>001122334456</UPC>
                </UPCs>
                <Price>23.99</Price>
                <Stock>15</Stock>
                <Availability>true</Availability>
                <Color>Red</Color>
                <ParentID>1001</ParentID>
            </Product>
            ...
    </Products>
</Feed>

Child <Product> Element (part of same feed)

<?xml version="1.0" encoding="UTF-8"?>
<Feed>
    <Categories>
    ...
    </Categories>
    <Products>
            ...
            <Product>
                <Name>V-neck T-Shirt</Name>
                <ProductUniqueID>1001</ProductUniqueID>
                <ProductUrl>...</ProductUrl>
                <ImageUrl>...</ImageUrl>
                <Description>...</Description>
                <CategoryID>cat-123</CategoryID>
                <UPCs>
                    <UPC>001122334455</UPC>
                    <UPC>001122334456</UPC>
                    <UPC>001122334457</UPC>
                    <UPC>001122334458</UPC>
                </UPCs>
                <Price>23.99</Price>
                <Stock>15</Stock>
                <Availability>true</Availability>
            </Product>
            ...
    </Products>
</Feed>

Parent <Product> Element (part of same feed)

<ProductUniqueID> for the child/color

<Product> element must be specific only

to the color/child level

Note that the child/color <Product> element always references back to the parent element by using <ParentID>.

Theoretically, you can have "infinite" child level products. However, it's best to only go down to the level where you will be moderating

photos to.

Example: if you want to tag photos down to the color level, but not size level, create <Products> element down to only color level

in the XML.

<Product> - Color (child) variant element - RED

<?xml version="1.0" encoding="UTF-8"?>
<Feed>
    <Categories>
    ...
    </Categories>
    <Products>
            ...
            <Product>
                <Name>V-neck T-Shirt</Name>
                <ProductUniqueID>10001-02</ProductUniqueID>
                <ProductUrl>...</ProductUrl>
                <ImageUrl>...</ImageUrl>
                <Description>...</Description>
                <CategoryID>cat-123</CategoryID>
                <UPCs>
                    <UPC>001122334455</UPC>
                    <UPC>001122334456</UPC>
                </UPCs>
                <Price>23.99</Price>
                <Stock>15</Stock>
                <Availability>true</Availability>
                <Color>Blue</Color>
                <ParentID>1001</ParentID>
            </Product>
            ...
    </Products>
</Feed>

Child <Product> Element (part of same feed)

<?xml version="1.0" encoding="UTF-8"?>
<Feed>
    <Categories>
    ...
    </Categories>
    <Products>
            ...
            <Product>
                <Name>V-neck T-Shirt</Name>
                <ProductUniqueID>1001</ProductUniqueID>
                <ProductUrl>...</ProductUrl>
                <ImageUrl>...</ImageUrl>
                <Description>...</Description>
                <CategoryID>cat-123</CategoryID>
                <UPCs>
                    <UPC>001122334455</UPC>
                    <UPC>001122334456</UPC>
                    <UPC>001122334457</UPC>
                    <UPC>001122334458</UPC>
                </UPCs>
                <Price>23.99</Price>
                <Stock>15</Stock>
                <Availability>true</Availability>
            </Product>
            ...
    </Products>
</Feed>

Parent <Product> Element (part of same feed)

<ProductUniqueID> for the child/color

<Product> element must be specific only

to the color/child level

Note that the child/color <Product> element always references back to the parent element by using <ParentID>.

Theoretically, you can have "infinite" child level products. However, it's best to only go down to the level where you will be moderating

photos to.

Example: if you want to tag photos down to the color level, but not size level, create <Products> element down to only color level

in the XML.

<Product> - Color (child) variant element - BLUE

<?xml version="1.0" encoding="UTF-8"?>
<Feed>
    <Categories>
    ...
    </Categories>
    <Products>
            ...
            <Product>
                <Name>V-neck T-Shirt</Name>
                <ProductUniqueID>10001-03</ProductUniqueID>
                <ProductUrl>...</ProductUrl>
                <ImageUrl>...</ImageUrl>
                <Description>...</Description>
                <CategoryID>cat-123</CategoryID>
                <UPCs>
                    <UPC>001122334455</UPC>
                    <UPC>001122334456</UPC>
                </UPCs>
                <Price>23.99</Price>
                <Stock>15</Stock>
                <Availability>true</Availability>
                <Color>Green</Color>
                <ParentID>1001</ParentID>
            </Product>
            ...
    </Products>
</Feed>

Child <Product> Element (part of same feed)

<?xml version="1.0" encoding="UTF-8"?>
<Feed>
    <Categories>
    ...
    </Categories>
    <Products>
            ...
            <Product>
                <Name>V-neck T-Shirt</Name>
                <ProductUniqueID>1001</ProductUniqueID>
                <ProductUrl>...</ProductUrl>
                <ImageUrl>...</ImageUrl>
                <Description>...</Description>
                <CategoryID>cat-123</CategoryID>
                <UPCs>
                    <UPC>001122334455</UPC>
                    <UPC>001122334456</UPC>
                    <UPC>001122334457</UPC>
                    <UPC>001122334458</UPC>
                </UPCs>
                <Price>23.99</Price>
                <Stock>15</Stock>
                <Availability>true</Availability>
            </Product>
            ...
    </Products>
</Feed>

Parent <Product> Element (part of same feed)

<ProductUniqueID> for the child/color

<Product> element must be specific only

to the color/child level

Note that the child/color <Product> element always references back to the parent element by using <ParentID>.

Theoretically, you can have "infinite" child level products. However, it's best to only go down to the level where you will be moderating

photos to.

Example: if you want to tag photos down to the color level, but not size level, create <Products> element down to only color level

in the XML.

<Product> - Color (child) variant element - GREEN

<?xml version="1.0" encoding="UTF-8"?>
<Feed>
    <Categories>
    ...
    </Categories>
    <Products>
            ...
            <Product>
                <Name>V-neck T-Shirt</Name>
                <ProductUniqueID>1001</ProductUniqueID>
                <ProductUrl>...</ProductUrl>
                <ImageUrl>...</ImageUrl>
                <Description>...</Description>
                <CategoryID>cat-123</CategoryID>
                <UPCs>
                    <UPC>001122334455</UPC>
                    <UPC>001122334456</UPC>
                    <UPC>001122334457</UPC>
                    <UPC>001122334458</UPC>
                </UPCs>
                <Price>23.99</Price>
                <Stock>15</Stock>
                <Availability>true</Availability>
            </Product>
            ...
    </Products>
</Feed>

Parent <Product> Element (part of same feed)

Note that *root* level elements do not have a <ParentID> element.

<Product> - Style (parent) element

TODO - add 3 tier example