# Webflow

<figure><img src="https://288200325-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLMXCx3JcaQfskPle5Mt5%2Fuploads%2FeeRhIaaW5Ayw81pMLFVp%2FGithub%20Webflow%20Google%20Review%20Header%20-%20Copy.png?alt=media&#x26;token=88c717b1-d0e6-4e92-9930-ea811cd25a53" alt=""><figcaption></figcaption></figure>

## 1. Getting Started

Building a social feed with Webflow is straightforward and efficient. Our advanced attribute system powers Webflow feeds, allowing you to seamlessly integrate attributes directly within the platform. This enables the display of live, real-time feed data without the constraints of basic widgets and embeds.

**Key Features:**

* **Attribute Integration:** Feeds are built by adding attributes directly to structure in Webflow.
* **Pre-made Layouts:** We provide a [collection of pre-made layouts](https://app.gitbook.com/o/l8pQwbrxdyJQf9u66a3s/s/LMXCx3JcaQfskPle5Mt5/) to get started faster.
* **Attributes Table:** You can view all available attributes in the [attributes table](#id-3.1.-available-attributes).
* **Flexability:** All attributes are optional (eg. caption, avatar), only the [feed wrapper](#id-2.1.-feed-wrapper) and [post wrapper](#id-2.2.-post-wrapper) are required.

### 1.1. Create Feed <mark style="color:red;">\*</mark>

From your [FeedSpring dashboard](#feedspring-setup), select the "**Connect New Feed**" option and follow the steps to create a new feed. For more detailed getting started instructions, [view our documentation](https://docs.feedspring.com/feedspring/getting-started) page.

### 1.2. Installation <mark style="color:red;">\*</mark>

Add the FeedSpring script to the **\<head>** of your Webflow project.

```javascript
<!-- FeedSpring Google Review Script -->
<script src="https://scripts.feedspring.com/google-reviews-attrs.js" async defer></script>
```

{% hint style="info" %}
**Webflow Code Settings:** If you plan to display the feed on multiple pages, add the following script to the project settings. For a feed displayed on a single page, add the script to the page settings. Learn more about Webflow custom code here.
{% endhint %}

### 1.3. Pre-made Components

FeedSpring offers a number of pre-made components that you can copy and paste directly into your projects. This can help you start customizing a feed right away and provides an excellent example of how a feed is built. Browse our [pre-made components here](https://app.gitbook.com/o/l8pQwbrxdyJQf9u66a3s/s/LMXCx3JcaQfskPle5Mt5/)

<figure><img src="https://288200325-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLMXCx3JcaQfskPle5Mt5%2Fuploads%2FnKcoPzewPjoUYbzDAjPO%2FPremade%20Layouts.gif?alt=media&#x26;token=23101567-4694-4a13-843e-d736884eceda" alt=""><figcaption></figcaption></figure>

***

## 2. Setup

### 2.1. Feed Wrapper <mark style="color:red;">\*</mark>

The Feed Wrapper specifies where the feed will be rendered on the page and can be added to any element that will enclose the entire feed. We recommend adding a new `<div>` block to wrap your feed and applying the attribute directly to this element.

Add the attribute `name="feedspring"` and`value="YOUR-UNIQUE-ID"` to the `<div>` block

{% hint style="info" %}
Your unique feed ID is available on the feed setup page within the app and can be copied directly from there.
{% endhint %}

<figure><img src="https://288200325-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLMXCx3JcaQfskPle5Mt5%2Fuploads%2FMPHj71hddu7fCoJFMqaF%2FFeed%20Wrapper.png?alt=media&#x26;token=25783861-e22d-443a-87bc-44f83dc69643" alt=""><figcaption><p>Wireframe example showing the the feed wrapper enclosing the entire feed</p></figcaption></figure>

### 2.2. Post Wrapper <mark style="color:red;">\*</mark>

The Post Wrapper contains the main content of a post and is nested inside the Feed Wrapper. This is where you'll add any layout elements related to your posts, such as captions or timestamps. To create the Post Wrapper, add the following attribute to a `<div>` block that will enclose your post. You can duplicate this block for as many posts as you wish to display.

Simply add the attribute `name="feedspring"` and`value="post"`

<figure><img src="https://288200325-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLMXCx3JcaQfskPle5Mt5%2Fuploads%2FXJNhjVpK0xUtH7NF50ua%2FPost%20Wrapper.png?alt=media&#x26;token=88357d51-2b0d-4d62-9898-da3ca5036bd0" alt=""><figcaption><p>Wireframe example showing the the post wrapper inside the previously created feed wrapper</p></figcaption></figure>

***

## 3. Building

Once the feed wrapper and the feed post have been created, you can start adding attributes to the required layout created inside them. For example, if you want to display a timestamp, you can add this attribute to a text element inside the post wrapper.

### 3.1. Available Attributes

The following attributes can be added to your layout to start displaying their respective data.

{% hint style="info" %}
**Post Attribute:** Some attributes can only be added to structure inside the post wrapper, these attributes are labeled as 'Post Attribute' below. All other attributes can be placed anywhere inside your feed wrapper.
{% endhint %}

<table data-full-width="false"><thead><tr><th width="208">Field</th><th width="189">Attribute Name</th><th width="188">Attribute Value</th><th data-type="checkbox">Post Attribute*</th></tr></thead><tbody><tr><td>Review Text</td><td>feed-field</td><td>review</td><td>true</td></tr><tr><td>Review Author Image</td><td>feed-field</td><td>avatar</td><td>true</td></tr><tr><td>Review Author Name</td><td>feed-field</td><td>name</td><td>true</td></tr><tr><td>Star (Active)</td><td>feed-field</td><td>star</td><td>true</td></tr><tr><td>Star (Inactive)</td><td>feed-field</td><td>star-inactive</td><td>true</td></tr><tr><td>Timestamp</td><td>feed-field</td><td>timestamp</td><td>true</td></tr><tr><td>Rating (#)</td><td>feed-field</td><td>rating</td><td>true</td></tr><tr><td>Rating (String)</td><td>feed-field</td><td>rating-string</td><td>true</td></tr><tr><td>Total Rating</td><td>feed-field</td><td>total</td><td>false</td></tr><tr><td>Average Rating</td><td>feed-field</td><td>average-rating</td><td>false</td></tr><tr><td>Link</td><td>feed-field</td><td>link</td><td>false</td></tr></tbody></table>

### 3.2. Build Feed

Building your feed is super simple, add the following attributes detailed below to your structural content and publish your site to see the feed in action.&#x20;

#### 3.2.1 Review Text

To display the **review text**, add the following attribute to a **\<text>** element on your page. Since this attribute is related to a post, it should be placed within an element that has the Post Wrapper.

`name="feed-field"` and `value="review"`

#### 3.2.2 Review Author Image

To display the **review author image**, add the following attribute to a **\<img>** element on your page. Since this attribute is related to a post, it should be placed within an element that has the Post Wrapper.

`name="feed-field"` and `value="avatar"`

#### 3.2.3 Review Authors Name

To display the **review author name**, add the following attribute to a **\<text>** element on your page. Since this attribute is related to a post, it should be placed within an element that has the Post Wrapper.

`name="feed-field"` and `value="name"`

#### 3.2.4 Star Rating

To display star ratings for your reviews, you need to include two elements in your layout:

1. **Active Star**: This represents a positive rating and is typically yellow and filled.
2. **Inactive Star**: This represents a missing rating and is usually greyed-out or has lower opacity.

FeedSpring will handle the display of these elements to reflect the rating. For example, for a 4/5 rating, FeedSpring will display 4 active stars and 1 inactive star.

**Active Star**

To display an active star, add the attribute:

`name="feed-field" value="star"`

**Inactive Star**

To display an inactive star, add the attribute:

`name="feed-field" value="star-inactive"`

#### 3.2.5 Timestamp

To display the **timestamp**, add the following attribute to a **\<text>** element on your page. Since this attribute is related to a post, it should be placed within an element that has the Post Wrapper.

`name="feed-field"` and `value="timestamp"`

{% hint style="info" %}
**Timestamp Format:** We also provide options to format the timestamp to suit your own requirements. Please review our [timestamp documentation](https://docs.feedspring.com/feedspring/getting-started/options-and-advanced/timestamps) to learn more about this.
{% endhint %}

#### 3.2.6 Rating (#)

To display the **rating**, add the following attribute to a **\<text>** element on your page. *This will display the rating as a number, for example '4'*

`name="feed-field"` and `value="rating"`

#### 3.2.7 Rating (String)

To display the **rating** as a string, add the following attribute to a **\<text>** element on your page. *This will display the rating as a string, for example 'four'*

`name="feed-field"` and `value="rating-string"`

#### 3.2.8 Total Rating

To display the **total rating**, add the following attribute to a **\<text>** element on your page.

`name="feed-field"` and `value="total"`

#### 3.2.9 Average Rating

To display the **average rating,** add the following attribute to a **\<text>** element on your page.

&#x20;`name="feed-field"` and `value="average-rating"`

#### 3.2.10 Link

To **link** to the business page, add the following attribute to a **\<link-block>** element on your page.

`name="feed-field"` and `value="link"`

***

## 4. Additional Settings

FeedSpring provides a range of advanced options to further customize your feeds and enhance their functionality. Explore the following sections to discover how to implement these features into your builds:

### 4.1 Feed Options

[Learn about additional options](https://docs.feedspring.com/feedspring/getting-started/options-and-advanced/feed-options) you can add to your feeds, such as language tags and more.

### 4.2 Placeholder & Loading

[Learn how to create a seamless](https://docs.feedspring.com/feedspring/getting-started/options-and-advanced/placeholder-and-loading) loading experience for your feeds using placeholders.

### 4.3 Dynamic Attribute

[Learn how to create a dynamic feed](https://docs.feedspring.com/feedspring/getting-started/options-and-advanced/dynamic-feeds), using the layout of a single post.

### 4.4 Timestamp

[Learn how to adjust timestamp format](https://docs.feedspring.com/feedspring/getting-started/options-and-advanced/timestamps) to suit exactly what you want for your feed.

### 4.5 Coded Solutions

[View our collection of coded solutions](https://docs.feedspring.com/feedspring/getting-started/options-and-advanced/custom-code) built to help you solve problems with simple CSS/JS
