Thursday, February 2, 2023

Return address label [return_address_label] - Google Merchant Center Help [gg-merchants-en]

Return address label [return_address_label]

The first return address that you create in Merchant Center will be your default return address. In addition to your default return address setting, you can add additional return addresses. Use the return address label [return_address_label] attribute to apply an alternative configured return address instead of the default return address to a product or group of products. Learn more about return settings requirements for selling on Google

When to use

Optional for all products.


Follow these formatting guidelines to make sure Google understands the data you're submitting.

For details on when and how to submit values in English, learn more about submitting your product data

Type Unicode characters (Recommended: ASCII only)
Limits Max 100 characters
Repeated field No
File format Example entry
Text feeds my_label
XML feeds <g:return_address_label>my_label</g:return_address_label>
If you choose to use the Content API to add this attribute, you'll need to use the custom attributes feature.
  Example entry

Content API (JSON)

"customAttributes": [


"name": "return_address_label",

"value": "my return address label"



To format your data for Content API, see the Content API for Shopping.


Follow these guidelines to make sure you submit high-quality data for your products.

Minimum requirements

These are the requirements you'll need to meet to show your product. If you don't follow these requirements, we'll disapprove your product and let you know in the Diagnostics page in your Merchant Center account.

  • Do not use this attribute if you only have one return address (the default address).
  • If you create multiple return addresses, you can add the return address label [return_address_label] attribute to your feed to override the default return address:
    • If the default address applies, do not provide this attribute.
    • If a non-default return address applies, add the label name for that return address for this attribute.
  • Use commas to separate multiple return address label values for a single product.
  • Do not use the comma symbol in return address label values.
  • Don't submit invalid unicode characters. These characters are generally added during your file's encoding process. To avoid them, use UTF-8 encoding. To help prevent encoding issues, submit files in a compressed format. Examples of invalid unicode characters include:
    • Control characters (for example, U+200D)
    • Function characters
    • Private area characters
    • Surrogate pairs
    • Unassigned code points

Best practices

These best practices can help you go beyond the basic requirements to optimize your product data for performance.

  • This feature works best when you need to accept returns to multiple addresses, for example, apparel returns to a warehouse in one location and accessories to a warehouse in a different location.


Products that use the default return address
Product data for a black skater dress
Attribute Value
Title [title] Skater dress - black
Google product category [google_product_category] Clothing & Accessories: > Clothing > Dresses
Return address label [return_address_label] (Leave blank)
Products that do not use the default return address
Product data for a casual black dress
Attribute Value
Title [title] Casual dress - Black
Google product category [google_product_category] Clothing & Accessories: > Clothing > Dresses
Return address label [return_address_label] my_second_warehouse_address_label

Need help? Click here to contact Buy on Google support.

No comments:

Post a Comment

Search This Blog

March 2020 - Authorized Buyers Help [gg-authorizedbuyers-en]

March 2020    Highlights Bid Tr...