---
title: Article Feeds
description: Source fields, recommendations, and examples for article and content feeds.
slug: indexing/feeds/articles
docKind: reference
hub: luigisbox-ai
---

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
<?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>
```

```json
{
  "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"]
    }
  ]
}
```

```csv
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:

```jsonl
{"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:

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

## See also

- [Feeds overview](/indexing/feeds/)
- [Catalog object model](/concepts/catalog-object-model/)
- [Feed troubleshooting](/indexing/feeds/troubleshooting/)