HTML

Learn how to get started building an Instagram feed with HTML Attributes.

1. Getting Started

Building a social feed with HTML is straightforward and efficient. Our advanced attribute system powers your feeds, allowing you to seamlessly integrate attributes directly into your own structure.

Key Features:

  • Attributes: Feeds are built by adding attributes directly to your HTML structure

  • Attributes Table: You can view all available attributes in the attributes table.

  • Flexability: All attributes are optional (eg. caption, avatar), only the feed wrapper and post wrapper are required.

1.1. Create Feed *

From your FeedSpring dashboard, select the "Connect New Feed" option and follow the steps to create a new feed. For more detailed getting started instructions, view our documentation page.

1.2. Installation *

Include the FeedSpring library in your HTML file:

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

1.3. Basic Usage

FeedSpring works by adding custom attributes to your HTML elements. These attributes define how the feed and its content are structured and displayed. Here’s a detailed example:

    <div feedspring="YOUR-UNIQUE-ID">
        <!-- User Info -->
        <div feed-field="avatar"></div>
        <div feed-field="username"></div>
        <div feed-field="follower-count"></div>
        <div feed-field="bio"></div>

        <!-- Posts -->
        <div feedspring="post">
            <div feed-field="caption"></div>
            <div feed-field="img"></div>
            <div feed-field="like-count"></div>
            <div feed-field="comment-count"></div>
        </div>
        <!-- Repeat the above <div feedspring="post"> block for multiple posts -->
    </div>

In this example, the feedspring attribute is used to wrap the entire feed and individual posts, while feed-field attributes are used to specify the content to display within each post.

2. Setup

2.1. Feed Wrapper

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" andvalue="YOUR-UNIQUE-ID" to the <div> block

<div feedspring="YOUR-UNIQUE-ID">
    <!-- Post elements go here -->
</div>

Your unique feed ID is available on the feed setup page within the app and can be copied directly from there.

2.2. Post Wrapper

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" andvalue="post"

<div feedspring="post">
    <!-- Fields for the post go here -->
</div>

3. Building

3.1. Available Attributes

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

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.

FieldAttribute NameAttribute ValuePost Attribute*

Review Text

feed-field

review

Review Author Image

feed-field

avatar

Review Author Name

feed-field

name

Star (Active)

feed-field

star

Star (Inactive)

feed-field

star-inactive

Timestamp

feed-field

timestamp

Rating (#)

feed-field

rating

Rating (String)

feed-field

rating-string

Total Rating

feed-field

total

Average Rating

feed-field

average-rating

Link

feed-field

link

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.

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" andvalue="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" andvalue="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" andvalue="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" andvalue="timestamp"

Timestamp Format: We also provide options to format the timestamp to suit your own requirements. Please review our timestamp documentation to learn more about this.

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" andvalue="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" andvalue="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" andvalue="total"

3.2.9 Average Rating

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

name="feed-field" andvalue="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" andvalue="average-rating"

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 you can add to your feeds, such as language tags and more.

4.2 Placeholder & Loading

Learn how to create a seamless loading experience for your feeds using placeholders.

4.3 Dynamic Attribute

Learn how to create a dynamic feed, using the layout of a single post.

4.4 Timestamp

Learn how to adjust timestamp format to suit exactly what you want for your feed.

4.5 Coded Solutions

View our collection of coded solutions built to help you solve problems with simple CSS/JS

PreviousFramerNextTikTok

Last updated