transit_time_label: Definition

If transit time varies for different groups of products, use transit_time_label and apply this attribute to the corresponding products in your feed. Use the transit time label in Merchant Center "Shipping settings" to define a specific transit time for each of the previously defined groups. Transit time labels help give your customers a more accurate estimated delivery date, which can help influence their purchase decision.

When to use

Optional for each product


Follow these formatting guidelines to make sure we understand the data you're submitting. 

Type Unicode characters (Recommended: ASCII only)
Repeated field No
Type Unicode characters (Recommended: ASCII only)
Repeated field No
File format Example entry
Text Dog food
XML feeds <g: transit_time_label>Dog food</g: transit_time_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 Diagnostics in your Merchant Center account.

  • 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 (e.g., 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 your items don’t always ship in the same amount of time. You might ship items via different carriers, from different origin warehouses, or using different shipping services (Ground, 2-day, etc).
  • Items using transit time labels should have consistent delivery times that don’t change frequently. Transit time labels can take up to 24 hours to update in the catalog, so this is not a good solution if transit times or inventory change throughout the business day.
  • If transit time labels don’t work for all of your items, consider using them for select items that benefit the most from accurate delivery estimates (for example, top sellers that consistently arrive in 2 days).


  • Most of your products ship quickly by air, but you offer some electronics with lithium batteries that need to ship by ground. Use a transit time label like “electronics” and assign it a longer transit time, so that customers know these items take a bit longer.
  • You have multiple warehouses. The assortment differs in all of them, but you make sure they all have popular items like toilet paper, so that you can offer 2-day ground shipping for free. Use a transit time label like “2day” and assign it a transit time of 0-2; that way customers know you offer quick shipping on the essentials they care about.
  • Your assortment is split across 3 warehouses in California, Texas, and Pennsylvania. Depending on what a customer orders, they may get it quickly because they live near the California warehouse, or it may take longer because it’s coming from Pennsylvania. Use transit time labels like “CA”, “TX”, and “PA” to designate which warehouse an item will be in. Then assign transit times based on how long it take for items to get across the country. For example, “CA” items may take 0-3 days to deliver to West Coast ZIPs, 4-6 days to the Midwest, and 7-10 days to the East Coast.
Was this helpful?
How can we improve it?

Need more help?

Sign in for additional support options to quickly solve your issue