> 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/attributes-reference.md). # Attributes Reference ## Attribute Reference Complete reference of every attribute used by the FeedSpring attributes delivery method. This page exists as a single source of truth for humans and AI coding agents. ### Wrapper attributes | Attribute | Purpose | | --------------------------- | ----------------------------------------------------------------------------- | | `feedspring="YOUR-FEED-ID"` | Outer feed wrapper. Declares which feed to render. | | `feedspring="post"` | Post template. Marks an element inside the wrapper as the repeating template. | | `feed-field="item"` | Alias for `feedspring="post"`. Both work identically. | | `feedspring="loading"` | Optional loading placeholder. Removed once feed rendering starts. | ### Feed ID prefixes | Prefix | Source | | ----------- | -------------- | | `inst_` | Instagram | | `google_` | Google Reviews | | `tiktok_` | TikTok | | `dribbble_` | Dribbble | ### Script URLs Load scripts inside the `` using `async defer`. Only load the scripts for feed types you are using. | Source | URL | | -------------- | --------------------------------------------------- | | Instagram | `https://scripts.feedspring.com/instagram-attrs.js` | | Google Reviews | `https://scripts.feedspring.com/google-attrs.js` | | TikTok | `https://scripts.feedspring.com/tiktok-attrs.js` | | Dribbble | `https://scripts.feedspring.com/dribbble-attrs.js` | ### Rendering Modes FeedSpring supports two rendering modes. #### Dynamic Rendering Recommended for most use cases. Enable dynamic rendering with: ```html feed-options="render:dynamic" ``` FeedSpring will automatically clone a single reusable post for each feed item: ```html
``` Example: ```html

``` This automatically renders 6 posts. *** #### Static Rendering Static rendering is the default mode. If `render:dynamic` is not enabled, FeedSpring only fills the existing: ```html
``` elements already in the DOM. This gives you full control over: * the number of rendered posts * custom layouts * advanced positioning structures Example: ```html
``` This renders 3 posts. ### Feed Options (feed-options) Placed on the feed wrapper. Format: ``` feed-options="name:value|name:value" ``` Example: ``` feed-options="render:dynamic|limit:6|lang:en" ``` ### Feed-Level Options | Option | Description | | ---------------- | --------------------------------------------- | | `render:dynamic` | Automatically clones a reusable post template | | `limit` | Limits the number of rendered posts | | `skip` | Skips posts from the beginning of the feed | | `lang` | Controls localization and number formatting | ### All `feed-field` values #### Instagram post fields | Attribute | Attribute | Type | | ------------ | --------------- | --------------------------------- | | `feed-field` | `img` | image URL | | `feed-field` | `bg` | image URL (as `background-image`) | | `feed-field` | `link` | URL | | `feed-field` | `caption` | string (innerHTML) | | `feed-field` | `like-count` | number (compact) | | `feed-field` | `comment-count` | number (compact) | | `feed-field` | `timestamp` | date-time | | `feed-field` | `avatar` | image URL | | `feed-field` | `name` | string | | `feed-field` | `username` | string | #### Instagram profile fields | JSON key | Attribute | Type | | ------------ | ----------------- | ---------------- | | `feed-field` | `avatar` | image URL | | `feed-field` | `name` | string | | `feed-field` | `username` | string | | `feed-field` | `bio` | string | | `feed-field` | `follower-count` | number (compact) | | `feed-field` | `following-count` | number (compact) | #### Google Reviews post fields | Attribute | JSON key | Type | | --------------- | ----------------- | ----------------------------- | | `review` | `comment` | string | | `name` | `author.name` | string | | `avatar` | `author.photoUrl` | image URL | | `rating` | `rating.number` | number (1-5) | | `rating-string` | `rating.string` | string ("five", "four", etc.) | | `star` | `rating.number` | repeater (active stars) | | `star-inactive` | `rating.number` | repeater (inactive stars) | | `timestamp` | `createdAt` | date-time | #### Google Reviews profile fields | Attribute | JSON key | Type | | ---------------- | --------------- | ------------------ | | `average-rating` | `averageRating` | number (1 decimal) | | `total` | `total` | number | #### TikTok post fields | Attribute | JSON key | Type | | --------------- | ----------------- | ------------------ | | `img` | `coverImageUrl` | image URL | | `video` | derived from `id` | iframe embed URL | | `link` | `shareUrl` | URL | | `title` | `title` | string (innerHTML) | | `description` | `description` | string (innerHTML) | | `duration` | `duration` | number | | `view-count` | `viewCount` | number (compact) | | `like-count` | `likeCount` | number (compact) | | `comment-count` | `commentCount` | number (compact) | | `share-count` | `shareCount` | number | | `timestamp` | `createTime` | date-time | #### TikTok profile fields | Attribute | JSON key | Type | | ----------------- | ---------------- | ------------------ | | `avatar` | `avatarUrl` | image URL | | `name` | `displayName` | string (innerHTML) | | `bio` | `bio` | string (innerHTML) | | `follower-count` | `followerCount` | number (compact) | | `following-count` | `followingCount` | number (compact) | | `total-likes` | `likesCount` | number (compact) | | `verified` | `isVerified` | boolean gate | #### Dribbble post fields | Attribute | JSON key | Type | | ----------- | ------------- | --------- | | `img` | `image` | image URL | | `link` | `url` | URL | | `title` | `title` | string | | `timestamp` | `publishedAt` | date-time | #### Dribbble profile fields | Attribute | JSON key | Type | | -------------- | ---------------- | ------------------ | | `avatar` | `avatarUrl` | image URL | | `name` | `name` | string | | `bio` | `bio` | string (innerHTML) | | `location` | `location` | string | | `profile-link` | `url` | URL | | `followers` | `followersCount` | number (compact) | ### Modifier attributes #### `feed-timestamp` Applied to an element with `feed-field="timestamp"`. Controls how the timestamp renders. | Value | Behaviour | | ------------------------ | ---------------------------------------------------------------------------------- | | `from-now` | Relative time: "2 days ago" | | Any Day.js format string | Passed directly to `dayjs().format(...)`, e.g. `MMMM D, YYYY`, `DD/MM/YY`, `HH:mm` | | *(omitted)* | Default format `MMMM D, YYYY` | Works on all feeds that implement a `timestamp` field. ### `feed-options` Placed on the feed wrapper. Pipe-delimited pairs: `name:value|name:value`. #### Feed-level options | Option | Description | Applies to | | ---------------- | ----------------------------------------------------- | ---------- | | `render:dynamic` | Clone a single post template for each item | All feeds | | `render:static` | Fill already-present post templates by index | All feeds | | `limit:N` | Maximum source index in dynamic mode (`0` = no limit) | All feeds | | `skip:N` | Skip first N items | All feeds | | `lang:xx-XX` | Locale for number formatting | All feeds | | `lang:auto` | Use runtime locale | All feeds | #### Post-level options Placed on the `feedspring="post"` element. | Option | Description | | ------------------------------- | ----------------------------------------- | | `appear:display-none` (default) | Clear inline `display:none` when rendered | | `appear:display-block` | Force `display: block` after render | | `appear:display-flex` | Force `display: flex` after render | ### Element behaviour The element a `feed-field` sits on controls what happens with the value: | Element | Behaviour | | ----------------- | ----------------------------------------------------------- | | `` | Sets `src` to the field value. Removes `srcset` if present. | | `` | Sets `href` to the field value. | | `