Quoted attributes

Each product in a tab-delimited product data source must appear on a single line without extra tabs or line breaks. If you just cut and paste product information directly and this content contains tabs, line breaks, or other formatting, our system won't be able to process this part of your product data source.

But if you surround this content with quotation marks (such as "product content [tab] product content [line break] product content"), our system treats everything within the quotation marks as a single attribute. Using quoted attributes can save you from having to retype or reformat existing content you'd like to use.

Note: If you use quoted attributes and your content already contains a quotation mark (for example, 12" Teflon Frying Pan), you must pair it with a second quotation mark so the system doesn't confuse this quotation with an attribute boundary. For example, instead of "12" Teflon Frying Pan", enter "12"" Teflon Frying Pan".

On this page


Get started

Quoted fields are automatically enabled for all newly created product data sources. If you need to enable quoted attributes in an existing product data source:

  1. In your Merchant Center account, select Settings Tools and setting menu icon [Gear] in the left navigation menu.
  2. Select Data sources.
  3. Under the “Product sources” tab, select a product source for which you’d like to enable quoted attributes.
  4. On the page that loads, select the Data source setup tab and click the pencil icon across the “Quoted fields” option.
  5. Select Using quoted fields.
  6. Select Save.

Note: Quoted attributes are not supported for Google Sheets data sources

 

  • For repeated attributes, you may include multiple values separated by a comma (,). If the values also contain commas (,), you should place the value containing commas in quotes ("). For example, for the product type [product_type] attribute, you could place each value in quotes, or just the value with commas:
    • "Home, Garden, and Yard > Outdoor Entertaining > Sofas", "Furniture > Outdoor Furniture > Sofas"
      or
    • "Home, Garden, and Yard > Outdoor Entertaining > Sofas", Furniture > Outdoor Furniture > Sofas"
  • For group attributes, you may include sub-attribute values separated by a colon (:). If a colon doesn't indicate a separate sub-attribute value, the value should be surrounded by quotes ("). Quotes (“) should only be used to enclose individual sub-attribute values, not the entire attribute. For example, for the product detail [product_detail] attribute you could provide:
    • General:Range:"10:20 inches"

Best practices 

If you add your products to Merchant Center using a tab-separated text file pay attention to special characters as follows:

  • For repeated attributes, wrap attribute or sub-attribute values with a quote (") if these values contain a comma (,), to ensure the comma is used literally and is not interpreted as an attribute-separator. 
  • For group attributes, also wrap sub-attribute values with a quote (") if these values contain a colon (:), to ensure it is used literally and is not interpreted as a sub-attribute separator. 
  • Don’t wrap an entire group attribute with double quotes, only the individual sub-attribute values.
  • If you use quoted values and your content already contains a quotation mark (for example, 12" Teflon Frying Pan), you must pair it with a second quotation mark so that the system doesn't confuse this quotation with an attribute boundary. For example, instead of "12" Teflon Frying Pan", enter "12"" Teflon Frying Pan".
  • Unlike Google sheets that are directly ingested in Merchant Center, don’t escape special characters with a backslash (\), as the backslash would be interpreted literally, as part of the value.
  • If you create a .tsv file by downloading the file from Google Sheets, use these same instructions when entering the values in the sheets and don’t use the instructions for downloading directly from the Google sheet into Merchant Center.
  • Quoted fields are automatically enabled for all newly created product data sources. If you need to enable quoted attributes in an existing product data source, enable this setting in your Merchant Center account. 
  • The same instructions apply to a TSV file downloaded from a Google sheet or one that is generated directly for example from a text editor or generated in code.
  • Don’t use CSV files due to commas being a reserved character used to separate attribute values. If you use Text files, use the TSV (tab-separated values) format.

Example

To submit multiple values for a repeated attribute, add all content in one cell, with the values separated by a comma. For example, let's say you want to submit the product details [product_detail] group attribute for a camera you are selling, with the following content, consisting of 4 sections (1 of which without a specific section name) and 14 values (rows) in total:

section_name

attribute_name

attribute_value

Connectivity

Connectivity Technology

HDMI, NFC, USB

Connectivity

Wireless Technology

BuiltIn 802.11b/g/n with NFC

Connectivity

Video Output

Type C Mini HDMI

Connectivity

Total Video Out Ports 2

Memory

Flash Memory Type:

Single Slot: SD/SDHC/SDXC (UHS-I)

Memory

Recording Capacity

30 Minutes

Memory

Write Speed

Several MB/s to over 100 MB/s

Memory

Windows Directory

C:\\camera\defaults

Camera Settings

Metering Methods

average,multi-zone,partial,spot

Camera Settings

Exposure Control

Auto, Manual, Program, Shutter Priority

Camera Settings

Crop Mode

APS-C, max. 12"

 

What's in the box?

Camera Body,Lens,Battery pack,Manual

  Warranty

1 year manufacturer

  Best Sellers Rank

1,065 in Electronics,#1 in DSLR Cameras

You’d submit this in one cell like this (note that values containing commas and colons are quoted, and that quotes are double quoted). Tab characters are represented by the <tab> symbol:

Header:     …<tab>product_detail<tab>
product row:    …<tab>Connectivity:Connectivity Technology:"HDMI, NFC, USB",Connectivity:Wireless Technology:BuiltIn 802.11b/g/n with NFC,Connectivity:Video Output:Type C Mini HDMI,Connectivity:Total Video Out Ports:2,Memory:Flash Memory Type:"Single Slot: SD/SDHC/SDXC (UHS-I)",Memory:Recording Capacity:30 Minutes,Memory:Write Speed:Several MB/s to over 100 MB/s,Memory:Windows Directory:"C:\\camera\defaults",Camera Settings:Metering Methods:"average,multi-zone,partial,spot",Camera Settings:Exposure Control:"Auto, Manual, Program, Shutter Priority",Camera Settings:Crop Mode:"APS-C max. 12""",:What's in the box?:"Camera Body,Lens,Battery pack,Manual",:Warranty:1 year manufacturer,:Best Sellers Rank:"#1,065 in Electronics,#1 in DSLR Cameras"<tab>

Alternatively, you can also create multiple separate columns, each containing one or more values. For example, to have one column for each section, you can submit this in 4 tab-separated columns as follows:

Header:     …<tab>product_detail<tab>product_detail<tab>product_detail<tab>product_detail<tab>
Product row:    …<tab>Connectivity:Connectivity Technology:"HDMI, NFC, USB",Connectivity:Wireless Technology:BuiltIn 802.11b/g/n with NFC,Connectivity:Video Output:Type C Mini HDMI,Connectivity:Total Video Out Ports:2<tab>Memory:Flash Memory Type:"Single Slot: SD/SDHC/SDXC (UHS-I)",Memory:Recording Capacity:30 Minutes,Memory:Write Speed:Several MB/s to over 100 MB/s,Memory:Windows Directory:"C:\\camera\defaults"<tab>Camera Settings:Metering Methods:"average,multi-zone,partial,spot",Camera Settings:Exposure Control:"Auto, Manual, Program, Shutter Priority",Camera Settings:Crop Mode:"APS-C max. 12"""<tab>:What's in the box?:"Camera Body,Lens,Battery pack,Manual",:Warranty:1 year manufacturer,:Best Sellers Rank:"#1,065 in Electronics,#1 in DSLR Cameras"<tab>

Lastly, you can also submit each value in its individual column, in which case you would need 14 columns as follows (only 3 columns shown), with a tab separating each column:

Header:     …<tab>product_detail<tab>product_detail<tab>product_detail<tab>
Product row:    …<tab>Connectivity:Connectivity Technology:"HDMI, NFC, USB"<tab>Connectivity:Wireless Technology:BuiltIn 802.11b/g/n with NFC<tab>Connectivity:Video Output:Type C Mini HDMI<tab>

Was this helpful?

How can we improve it?
Search
Clear search
Close search
Main menu
523634457176834184
true
Search Help Center
false
true
true
true
true
true
71525
false
false
true
false