Article Feeds

Article feeds describe editorial content such as blog posts, buying guides, help content, and landing pages that should appear in discovery results. The configured object type is article.

Core fields

Source field	Type	Requirement	Description
id	String	Required	Type-prefixed article identifier, such as article/summer-shoes-guide.
title	String	Required	Article title shown to users.
url	String	Recommended	Canonical article URL.

Recommended fields

Source field	Type	Requirement	Description
annotation	String	Optional	Short summary or excerpt.
text	String	Optional	Main article text used for matching.
image_url	String	Optional	Article image URL.
published_at	Date	Optional	Publication date in ISO 8601 format.
category	String or array	Optional	Stable category IDs mapped to canonical @category references.

You can add other content attributes such as author, tags, or reading time.

Guidance

• Use canonical public URLs rather than temporary preview URLs.
• Use consistent date formats.
• Do not include private drafts or internal notes unless the integration explicitly requires private content.

Examples

• XML
• JSON
• CSV

<?xml version="1.0" encoding="UTF-8"?>
<articles>
  <article>
    <id>article/summer-shoes-guide</id>
    <title>How to choose summer shoes</title>
    <url>https://example.com/blog/how-to-choose-summer-shoes</url>
    <annotation>A practical guide to materials, fit, and comfort.</annotation>
    <text>Compare breathable materials, heel support, and room for movement.</text>
    <image_url>https://cdn.example.com/articles/summer-shoes.jpg</image_url>
    <published_at>2026-05-20</published_at>
    <category>category/buying-guides</category>
  </article>
</articles>

{
  "articles": [
    {
      "id": "article/summer-shoes-guide",
      "title": "How to choose summer shoes",
      "url": "https://example.com/blog/how-to-choose-summer-shoes",
      "annotation": "A practical guide to materials, fit, and comfort.",
      "text": "Compare breathable materials, heel support, and room for movement.",
      "image_url": "https://cdn.example.com/articles/summer-shoes.jpg",
      "published_at": "2026-05-20",
      "category": ["category/buying-guides"]
    }
  ]
}

id,title,url,annotation,text,image_url,published_at,category
article/summer-shoes-guide,How to choose summer shoes,https://example.com/blog/how-to-choose-summer-shoes,"A practical guide to materials, fit, and comfort.","Compare breathable materials, heel support, and room for movement.",https://cdn.example.com/articles/summer-shoes.jpg,2026-05-20,category/buying-guides

The same record in JSON Lines is one complete object on one line:

{"id":"article/summer-shoes-guide","title":"How to choose summer shoes","url":"https://example.com/blog/how-to-choose-summer-shoes","annotation":"A practical guide to materials, fit, and comfort.","text":"Compare breathable materials, heel support, and room for movement.","image_url":"https://cdn.example.com/articles/summer-shoes.jpg","published_at":"2026-05-20","category":["category/buying-guides"]}

After mapping, the standardized category field uses a typed reference:

{
  "@id": "article/summer-shoes-guide",
  "@type": "article",
  "@title": "How to choose summer shoes",
  "@category": ["category/buying-guides"]
}

See also

• Feeds overview
• Catalog object model
• Feed troubleshooting