Your data feed must be in one of the supported formats listed below. For help choosing a format, please see our feed format page.
Please ensure your feed follows the Google Base Program Policies.
When creating your feed, you will need to provide information about your items in the form of attributes. Click on any attribute below to view the attribute's definition.
Required
- description
| Text describing the item. Do not include promotional or boilerplate text, such as "Free shipping!" or "Click here now!" We search over this text when matching user queries to your item. Please make sure you include the same item description available on your website in the description field in your data feed. |
Format:
Text, up to a maximum length of 10,000 characters. |
Tab-delimited example:
Basic apple pie recipe you can make with your children. |
XML example:
<description>Basic apple pie recipe you can make with your children.</description> |
- link
| The URL of the web page associated with the item. This should not forward to another URL; it must point directly to the target page. The domain name may not be an IP address. |
Format:
URL. (Must include the http:// portion.) |
Tab-delimited example:
http://www.example.com/asp/sp.asp?cat=12&id=1030 |
XML example:
<link>http://www.example.com/asp/sp.asp?cat=12&id=1030</link> |
- main_ingredient
| The defining component in the recipe. |
Format:
Text. |
Tab-delimited example:
tofu |
XML example:
<g:main_ingredient>tofu</g:main_ingredient> |
- servings
| The total number of helpings in the finished recipe. |
Format:
Number |
Tab-delimited example:
6 |
XML example:
<g:servings>6</g:servings> |
- title
| The name or title of the item. |
Format:
Text. Maximum length of 80 characters. Commas are allowed. |
Tab-delimited example:
Classic Apple Pie |
XML example:
<title>Classic Apple Pie</title> |
Recommended
- cooking_time
| The total time needed for a recipe to be prepared/cooked. |
Format:
Number, in minutes. |
Tab-delimited example:
30 |
XML example:
<g:cooking_time>30</g:cooking_time> |
- course
| The part of a meal the recipe belongs to. |
Format:
Text. |
Tab-delimited example:
main entree |
XML example:
<g:course>main entree</g:course> |
- cuisine
| The style of cooking the recipe falls under. |
Format:
Text. |
Tab-delimited example:
Italian |
XML example:
<g:cuisine>Italian</g:cuisine> |
- id
| A unique alphanumeric identifier for the item - e.g., your internal ID code. IMPORTANT: Once you submit an item with a unique id, this identifier must not change when you send in a new data feed. Each item must retain the same id in subsequent feeds. |
Format:
Text. |
Tab-delimited example:
01flx |
XML example:
<g:id>01flx</g:id> |
- image_link
| The URL of an associated image for the item. Use your full-sized images, not thumbnail images. If you do not have an image available, leave the attribute blank. Do not include logos or an image that says, "Image not available." |
Format:
URL. (Must include the http:// portion.) Up to 10 URLs can be included. For tab-delimited, separate each URL by a comma. For XML, include each URL as a separate <image_link> attribute. |
Tab-delimited example:
http://www.example.com/image1.jpg,http://www.example.com/image2.jpg |
XML example:
<g:image_link>http://www.example.com/image1.jpg</g:image_link>
<g:image_link>http://www.example.com/image2.jpg</g:image_link> |
- meal_type
| A time or occasion the recipe is normally prepared for. |
Format:
Text. |
Tab-delimited example:
breakfast |
XML example:
<g:meal_type>breakfast</g:meal_type> |
- preparation_time
| The amount of time the recipe requires to be prepared. |
Format:
Number, in minutes. |
Tab-delimited example:
30 |
XML example:
<g:preparation_time>30</g:preparation_time> |
Optional
- calories
| The total number of calories in the recipe. |
Format:
Number. |
Tab-delimited example:
150 |
XML example:
<g:calories>150</g:calories> |
- cholesterol
| The total amount of cholesterol in the recipe. |
Format:
Number, in milligrams. |
Tab-delimited example:
25 |
XML example:
<g:cholesterol>25</g:cholesterol> |
- fiber
| The amount of fiber in a single recipe serving. |
Format:
Number in grams. |
Tab-delimited example:
9 |
XML example:
<g:fiber>9</g:fiber> |
- protein
| The amount of protein in a recipe serving. |
Format:
Number, in grams. |
Tab-delimited example:
25 |
XML example:
<g:protein>25</g:protein> |
- saturated_fat
| The amount of saturated fat in a recipe serving. |
Format:
Number, in grams. |
Tab-delimited example:
3 |
XML example:
<g:saturated_fat>3</g:saturated_fat> |
- sodium
| The amount of sodium in a recipe serving. |
Format:
Number, in milligrams. |
Tab-delimited example:
1010 |
XML example:
<g:sodium>1010</g:sodium> |
- total_carbs
| The amount of carbohydrates in a recipe serving. |
Format:
Number, in grams. |
Tab-delimited example:
22 |
XML example:
<g:total_carbs>22</g:total_carbs> |
- total_fat
| The amount of fat in a recipe serving. |
Format:
Number, in grams. |
Tab-delimited example:
8 |
XML example:
<g:total_fat>8</g:total_fat> |
Other Attributes
If you have attributes that do not fit into one of the predefined attributes listed above, you can still send them to us. Check these resources for more information:
> Register Data Feed
