Skip to content

Temu Product XML

This article provides a detailed explanation of the Product data model we use to import listings into Temu, including all of its elements and how they are used to describe a product, its attributes, variants and associated data.

This model is used exclusively with the Import Products task.

Sample XML

<Products>
    <Product> 
        <ExternalId>JKL</ExternalId>
        <GoodsBasic>
            <Categories>
                <Category>
                    <Name>Clothing, Shoes &amp; Jewelry</Name>
                </Category>
                <Category>
                    <Name>Women</Name>
                </Category>
                <Category>
                    <Name>Watches</Name>
                </Category>
            </Categories>
            <CategoryName>Wrist Watches</CategoryName>
            <GoodsName>Casio Pink</GoodsName>
            <Sku>CASIO006</Sku>
        </GoodsBasic>
        <Description>The Casio Pink waterproof digital watch...</Description>
        <GoodsServicePromise>
            <CostTemplateName>SUSHIL KUMAR GUPTA</CostTemplateName>
            <FulfillmentType>1</FulfillmentType>
            <ShipmentLimitDay>2</ShipmentLimitDay>
        </GoodsServicePromise>
        <GoodsOrigin>
            <PrimaryOrigin>United Kingdom</PrimaryOrigin>
        </GoodsOrigin>
        <Template>
            <Fields>
                <Field>
                    <Name>Watches case material</Name>
                    <Value>Acrylic</Value>
                </Field>
                <Field>
                    <Name>Movement</Name>
                    <Value>Mechanical Watch</Value>
                </Field>
                <Field>
                    <Name>Band Material</Name>
                    <Value>Ceramic</Value>
                </Field>
                <Field>
                    <Name>Wireless Property</Name>
                    <Value>With Wi-Fi function</Value>
                </Field>
                <Field>
                    <Name>Battery Properties</Name>
                    <Value>Rechargeable Battery</Value>
                </Field>
                <Field>
                    <Name>Rechargeable Battery</Name>
                    <Value>Nickel Battery</Value>
                </Field>
                <Field>
                    <Name>Battery Capacity (mAh)</Name>
                    <Value>24</Value>
                </Field>
            </Fields>
        </Template>
        <Variants>
            <Variant>
                <Price>
                    <BasePrice>
                        <Currency>GBP</Currency>
                        <Amount>9.99</Amount>
                    </BasePrice>
                </Price>
                <Quantity>100</Quantity>
                <Specifications>
                    <Specification>Color</Specification>
                    <Specification>Size</Specification>
                </Specifications>
                <Sku>CASIP001</Sku>
                <Weight>5</Weight>
                <WeightUnit>g</WeightUnit>
                <Length>10</Length>
                <Width>10</Width>
                <Height>10</Height>
                <VolumeUnit>cm</VolumeUnit>
                <Images>
                    <Image>https://res.cloudinary.com/demo/image/upload/v1312461204/sample.jpg</Image>
                </Images>
            </Variant>
            <Variant>
                <Price>
                    <BasePrice>
                        <Currency>GBP</Currency>
                        <Amount>9.99</Amount>
                    </BasePrice>
                </Price>
                <Quantity>100</Quantity>
                <Specifications>
                    <Specification>Color</Specification>
                    <Specification>Size</Specification>
                </Specifications>
                <Sku>CASIP002</Sku>
                <Weight>5</Weight>
                <WeightUnit>g</WeightUnit>
                <Length>10</Length>
                <Width>10</Width>
                <Height>10</Height>
                <VolumeUnit>cm</VolumeUnit>
                <Images>
                    <Image>https://res.cloudinary.com/demo/image/upload/v1312461204/sample.jpg</Image>
                </Images>
            </Variant>
        </Variants>
        <TaxCode>
            <ItemTaxCode>GEN_STANDARD</ItemTaxCode>
        </TaxCode>
    </Product>
</Products>

Elements

ExternalId

  • Element: <ExternalId>
  • Description: A unique identifier used to reference the product in external systems.
  • Example: JKL

GoodsBasic

Contains the core details of the product, such as its category, name, and SKU (stock-keeping unit).

CategoryId

  • Element: <CategoryId>
  • Description: The unique identifier to represent the category in Temu.
  • Example: 123
  • Mandatory: Yes, but only when the CategoryName element has not been provided.

CategoryName

  • Element: <CategoryName>
  • Description: The most specific category name.
  • Example: Wrist Watches
  • Mandatory: Yes, but only when the CategoryId element has not been provided.

Categories

  • Element: <Categories>
  • Description: A hierarchical list of Category model that represents where the product belongs.
  • Notes: As shown in the example below, the list should descend from the base category (e.g., Clothing, Shoes &amp; Jewelry > Women > Watches > Wrist Watches).
Example
<Categories>
    <Category>
        <Name>Clothing, Shoes &amp; Jewelry</Name>
    </Category>
    <Category>
        <Name>Women</Name>
    </Category>
    <Category>
        <Name>Watches</Name>
    </Category>
</Categories>

GoodsName

  • Element: <GoodsName>
  • Description: The product’s display name.
  • Example: Casio Pink
  • Mandatory: Yes, but only when creating a new product.

Sku

  • Element: <Sku>
  • Description: A unique identifier used to track inventory.
  • Example: CASIO006

Description

  • Element: <Description>
  • Description: A narrative description of the product for marketing or informational use.
  • Example: The Casio Pink waterproof digital watch...

GoodsServicePromise

Defines fulfillment expectations and associated cost settings.

CostTemplateId

  • Element: <CostTemplateId>
  • Description: The unique identifier to represent the cost template in Temu.
  • Example: 123
  • Mandatory: Yes, but only when creating a new product and the CostTemplateName element has not been provided.

CostTemplateName

  • Element: <CostTemplateName>
  • Description: Name of the cost template or provider.
  • Example: SUSHIL KUMAR GUPTA
  • Mandatory: Yes, but only when creating a new product and the CostTemplateId element has not been provided.

FulfillmentType

  • Element: <FulfillmentType>
  • Description: Indicates how the product will be delivered. (e.g., 1 = Standard Fulfillment, depending on system context.)
  • Example: 1

ShipmentLimitDay

  • Element: <ShipmentLimitDay>
  • Description: Number of days within which the product must be shipped.
  • Example: 2

GoodsOrigin

  • Element: <GoodsOrigin>
  • Description: The country or region where the product originates.

Example

<GoodsOrigin>
    <PrimaryOrigin>United Kingdom</PrimaryOrigin>
</GoodsOrigin>

Template

A collection of custom product attributes or specifications related to the given Category.

  • Element: <Template>
  • Description: A collection of the Field model to represent the category's template.
  • Mandatory: Yes.
  • Notes: The template's mandatory properties are assigned in Temu itself. The Import Products task will identify these and log an error.

Example

<Template>
    <Fields>
        <Field>
            <Name>Watches case material</Name>
            <Value>Acrylic</Value>
        </Field>
        <Field>
            <Name>Movement</Name>
            <Value>Mechanical Watch</Value>
        </Field>
    </Fields>
</Template>

Variants

A collection of sub-products that are differentiated by the given specifications.

  • Element: <Variant>
  • Description: A collection of the Variant model to represent the products different options.
  • Mandatory: Yes.

Example

<Variant>
    <Price>
        <BasePrice>
            <Currency>GBP</Currency>
            <Amount>9.99</Amount>
        </BasePrice>
    </Price>
    <Quantity>100</Quantity>
    <Specifications>
        <Specification>Color</Specification>
        <Specification>Size</Specification>
    </Specifications>
    <Sku>CASIP001</Sku>
    <Weight>5</Weight>
    <WeightUnit>g</WeightUnit>
    <Length>10</Length>
    <Width>10</Width>
    <Height>10</Height>
    <VolumeUnit>cm</VolumeUnit>
    <Images>
        <Image>https://res.cloudinary.com/demo/image/upload/v1312461204/sample.jpg</Image>
    </Images>
</Variant>

TaxCode

  • Element: <TaxCode>
  • Description: A code representing the applicable tax category.

Example

<TaxCode>
    <ItemTaxCode>GEN_STANDARD</ItemTaxCode>
</TaxCode>