> For the complete documentation index, see [llms.txt](https://docs.feedspring.com/introduction/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.feedspring.com/introduction/core-concepts/posts-and-fields.md).

# Posts & Fields

How FeedSpring structures feed data into posts and fields, and why that structure is the same across every delivery method.

Every FeedSpring feed is made up of posts and fields.

Understanding this structure is the key to building layouts with FeedSpring.

<figure><img src="https://3828662318-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKLkySY85psZLfsr3znlv%2Fuploads%2Fgit-blob-2430f4f7102c2c41ffb2d1715dc05c0f3de25a37%2Fmain-cta.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3828662318-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKLkySY85psZLfsr3znlv%2Fuploads%2Fgit-blob-19a8a96b03fd90e7de17cb218f8f9015ab8c2529%2Fdivider-blog.png?alt=media" alt=""><figcaption></figcaption></figure>

### What is a post?

A post is a single item inside a feed.

Depending on the source, this could be:

* An Instagram post
* A Google review
* A TikTok video
* A Dribbble shot

Each feed contains multiple posts.

<figure><img src="https://3828662318-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKLkySY85psZLfsr3znlv%2Fuploads%2Fgit-blob-19a8a96b03fd90e7de17cb218f8f9015ab8c2529%2Fdivider-blog.png?alt=media" alt=""><figcaption></figcaption></figure>

### What is a field?

A field is a piece of data inside a post.

For example:

* An image
* A caption or description
* A link
* A timestamp
* A rating

Fields are what you use to display content.

<figure><img src="https://3828662318-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKLkySY85psZLfsr3znlv%2Fuploads%2Fgit-blob-19a8a96b03fd90e7de17cb218f8f9015ab8c2529%2Fdivider-blog.png?alt=media" alt=""><figcaption></figcaption></figure>

### Example

Here is a simplified example of a post:

```json
{
  "img": "image-url.jpg",
  "caption": "New product launch",
  "link": "https://...",
  "timestamp": "2026-01-01T12:00:00Z"
}
```

Each key is a field.

<figure><img src="https://3828662318-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKLkySY85psZLfsr3znlv%2Fuploads%2Fgit-blob-19a8a96b03fd90e7de17cb218f8f9015ab8c2529%2Fdivider-blog.png?alt=media" alt=""><figcaption></figcaption></figure>

### Fields are different for each feed

Each platform provides different data.

#### Instagram (Preview)

{% hint style="info" %}
Just a preview, view all attributes on the [Instagram](/introduction/feeds/instagram.md) feeds page
{% endhint %}

* `img`
* `caption`
* `like-count`
* `comment-count`

#### Google Reviews (Preview)

{% hint style="info" %}
Just a preview, view all attributes on the [Google Review](/introduction/feeds/google-reviews.md) feeds page
{% endhint %}

* `review`
* `rating`
* `name`
* `avatar`

#### TikTok (Preview)

{% hint style="info" %}
Just a preview, view all attributes on the [TikTok](/introduction/feeds/tiktok.md) feeds page
{% endhint %}

* `img`
* `description`
* `view-count`
* `like-count`

#### Dribbble (Preview)

{% hint style="info" %}
Just a preview, view all attributes on the [Dribbble](/introduction/feeds/dribbble.md) feeds page
{% endhint %}

* `img`
* `title`
* `link`
* `timestamp`

👉 See each feed pages for the full list of fields.

<figure><img src="https://3828662318-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKLkySY85psZLfsr3znlv%2Fuploads%2Fgit-blob-19a8a96b03fd90e7de17cb218f8f9015ab8c2529%2Fdivider-blog.png?alt=media" alt=""><figcaption></figcaption></figure>

### Profile fields vs post fields

Feeds also include profile-level data.

#### Profile fields

These describe the account or source:

* Name
* Avatar
* Bio
* Follower count

#### Post fields

These describe individual items:

* Image or media
* Text content
* Timestamp
* Engagement data

Both can be used when building layouts.

<figure><img src="https://3828662318-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKLkySY85psZLfsr3znlv%2Fuploads%2Fgit-blob-19a8a96b03fd90e7de17cb218f8f9015ab8c2529%2Fdivider-blog.png?alt=media" alt=""><figcaption></figcaption></figure>

### How fields are used

Every delivery method works with the same fields. Only the way you refer to them changes. For example, an Instagram post's image:

| Method                                                  | How you use it                                        |
| ------------------------------------------------------- | ----------------------------------------------------- |
| [Attributes](/introduction/attributes/overview.md)      | `<img feed-field="img">`                              |
| [GraphQL API](/introduction/graphql-api/overview.md)    | `posts { nodes { image { url } } }`                   |
| [Framer components](/introduction/build-with/framer.md) | Shown automatically, styled through property controls |

Each feed page lists every field with both its attribute name and its GraphQL field.

<figure><img src="https://3828662318-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKLkySY85psZLfsr3znlv%2Fuploads%2Fgit-blob-19a8a96b03fd90e7de17cb218f8f9015ab8c2529%2Fdivider-blog.png?alt=media" alt=""><figcaption></figcaption></figure>

### Why this matters

Once you understand posts and fields:

* You can build any layout
* You can switch between delivery methods
* You can combine feeds across platforms

This is the core of how FeedSpring works.

<figure><img src="https://3828662318-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKLkySY85psZLfsr3znlv%2Fuploads%2Fgit-blob-19a8a96b03fd90e7de17cb218f8f9015ab8c2529%2Fdivider-blog.png?alt=media" alt=""><figcaption></figcaption></figure>

### Summary

* A feed contains posts
* Each post contains fields
* Fields are the data you display
* Fields vary by platform
* The structure is always the same