Document link [document_link]

Use the document link [document_link] attribute to provide links to authoritative product documentation in the form of PDF files. Examples are training manuals, user guides, assembly instructions, package inserts, and more.

On this page

• When to use
• Format
• Minimum requirements
• Best practices
• Examples

---

When to use

Optionalfor each product

Use this attribute to submit PDF documents that contain relevant information about your product. The documents will be used primarily in conversational AI experiences, for example, to answer detailed user questions about the product and to guide their research and buying decisions.

The document link [document_link] attribute can be used in all countries.

---

Format

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

Type	Document URL (Must start with "http://" or "https://"), ASCII characters only, and RFC 3986 compliant
Limits	Up to 2,000 characters
Supported file formats	.PDF
Repeated field	Yes, up to 5
Schema.org property ( What's this? )	No

File format	Example value
Text (TSV or CSV) data sources	https://example.com/manual.pdf To submit more than one PDF file, separate each URL with a comma ( , ): https://example.com/manual.pdf, https://example.com/assembly_instructions.pdf
XML data sources	<g:document_link> https://example.com/manual.pdf </g:document_link>
API data sources	To format your data in the Merchant API, check the Merchant API  resource.

---

Minimum requirements

These are the requirements you'll need to meet to provide a valid document link for your product.

• URL requisites:
  • All document links must use a URL, starting with “http://” or “https://”.
  • Replace any special characters in URLs with their URL-encoded equivalents. For example, replace commas with %2C. Refer to a URL encoding reference for a complete list.
  • The URL must point to a PDF file
• File size: The file must have a maximum file size of 50 MB.
• Ownership and accessibility:
  • You must own the rights to share the document for marketing purposes
  • The URL must be publicly accessible on the web. Googlebot must be able to access documents publicly without requiring logins or special permissions and with no restrictions in robots.txt. URL must be stable (not reused for different videos) and crawlable by Google.
• Content:
  • Document links should be static and shouldn’t expire.

---

Best practices

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

• The document should be about your product(possibly together with multiple other related products) and contain relevant product information.
• Product information can be textualas well as graphics.
• Don’t submit documents that represent your companyinstead of the product itself.
• Submit high quality, authoritative, documents. Documents should have a coherent structure and clear purpose.
• Provide all documents that are relevant for consumersto learn more about your product, including for example training manuals, user guides, assembly instructions, package inserts, and designs for the product packaging (including QR or barcodes).

---

Examples