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:
Responsibilities include working with the corporate marketing group, sales, and product support to drive projects such as: defining and implementing a customer communications strategy; determining ROI on advertising expenditures. |
XML example:
<description>Responsibilities include working with the corporate marketing group, sales, and product support to drive projects such as: defining and implementing a customer communications strategy; determining ROI on advertising expenditures.</description> |
- employer
| The company providing employment. |
Format:
Text. |
Tab-delimited example:
Google Inc. |
XML example:
<g:employer>Google Inc.</g:employer> |
- job_function
| The function of the employment position. |
Format:
Text. |
Tab-delimited example:
Product manager |
XML example:
<g:job_function>Product manager</g:job_function> |
- 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> |
- location
| The location of the item. |
Format:
Addresses should be formatted as: street, city, state, postal code, country. Each location element should be separated by a comma. Locations are validated through Google Maps. |
Tab-delimited example:
1600 Amphitheatre Parkway, Mountain View, CA, 94043, USA |
XML example:
<g:location>1600 Amphitheatre Parkway, Mountain View, CA, 94043, USA</g:location> |
- title
| The name or title of the item. |
Format:
Text. Maximum length of 80 characters. Commas are allowed. |
Tab-delimited example:
Marketing manager |
XML example:
<title>Marketing manager</title> |
Recommended
- education
| The level of education required for the employment position. |
Format:
Text. |
Tab-delimited example:
PhD |
XML example:
<g:education>PhD</g:education> |
- job_industry
| The industry of the employment position. |
Format:
Text. |
Tab-delimited example:
Government |
XML example:
<g:job_industry>Government</g:job_industry> |
- job_type
| The type of employment position. |
Format:
Text. Appropriate values include: full-time, part-time, and contractor, etc. |
Tab-delimited example:
contractor |
XML example:
<g:job_type>contractor</g:job_type> |
- publish_date
| The date the job was published. |
Format:
ISO 8601 format: YYYY-MM-DD. Note: all dates and times are in PST (GMT -8). |
Tab-delimited example:
2005-12-20 |
XML example:
<g:publish_date>2005-12-20</g:publish_date> |
- salary
| The salary for this position. |
Format:
Number. Non-numeric values such as $ symbols are not acceptable. |
Tab-delimited example:
55000 |
XML example:
<g:salary>55000</g:salary> |
Optional
- expiration_date
| The date that the item listing expires or that information about this item is going to change. |
Format:
ISO 8601 format: YYYY-MM-DD. Note: all dates and times are in PST (GMT -8). |
Tab-delimited example:
2006-12-20 |
XML example:
<g:expiration_date>2006-12-20</g:expiration_date> |
- 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> |
- immigration_status
| The legal residency requirements for the employment position. |
Format:
Text. |
Tab-delimited example:
permanent resident |
XML example:
<g:immigration_status>permanent resident</g:immigration_status> |
- salary_type
| The type of salary associated with the employment position. |
Format:
Accepted values are: starting and negotiable. The default is starting. |
Tab-delimited example:
negotiable |
XML example:
<g:salary_type>negotiable</g:salary_type> |
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
