Instagram Feed Option Features – PRO vs. Free

A table of every Instagram Feeds setting and whether it is available in the free or Pro version of the plugin.

Would you like to know which shortcode options Instagram Feed accepts, and which of them the free version has?

In this guide, you’ll find every shortcode option, what it does, the values it accepts, and whether the free version includes it.

For the features that come with each license level, see our guide to the differences between the free version and Instagram Feed Pro.

Before you get started, make sure Instagram Feed is installed and activated on your site.

• How Do Shortcode Options Work?
• Shortcode Options for Feed Builder Feeds
• Legacy Shortcode Options
  • Feed Source Options
  • Layout and Size Options
  • Carousel Options
  • Highlight Options
  • Post Options
  • Lightbox Comments and Hover Options
  • Header Options
  • Caption, Likes, and Comments Options
  • Load More and Follow Button Options
  • Post Filtering and Moderation Options
  • Caching and Other Options
• Frequently Asked Questions

How Do Shortcode Options Work?

Each feed you make in the feed builder has its own shortcode, such as [instagram-feed feed=3]. You set the feed’s options in the feed builder. The shortcode only says which feed to show.

A shortcode without a feed option shows feed 1, unless the site still has a legacy feed.

Most options in this guide are legacy shortcode options. They work only in a shortcode with no feed option. The site must also have been updated from an older version of the plugin and still have a legacy feed. Learn more in our guide to Instagram legacy feeds.

In the tables below, the Free 6.15.1 column says whether the free version reads the option. The Instagram Feed Pro column says the license level that includes it. Each license level includes everything in the levels before it. “Basic and up” means Basic, Plus, and Elite. Options that are not part of a Plus or Elite feature come with every license level.

Shortcode Options for Feed Builder Feeds

A shortcode for a feed made in the feed builder reads only the options in this table. The plugin ignores any other option you add to the shortcode.

Option	What it does	Accepted values	Free 6.15.1	Instagram Feed Pro
feed	The ID of the feed to show, such as [instagram-feed feed=3].	The ID of a feed	Yes	Basic and up
class	A CSS class added to the feed container.	A class name	Yes	Basic and up
headersource	The connected account the header shows, by username or user ID.	A username or user ID	Yes	Basic and up
cachetime	Caches the feed’s page for this many minutes.	A number of minutes	No	Basic and up
permanent	Keeps a permanent copy of the feed so the plugin never looks for new posts.	true or false	No	Basic and up
moderationmode	Shows the Moderation Mode link on the front end of the site, where you pick which posts to show or hide. Only users who can edit posts see the link.	true or false	No	Plus and up
hidephotos	Hides these posts.	Post IDs separated by commas	No	Plus and up
mediavine	Turns on the Mediavine integration.	true or false	No	Basic and up

Legacy Shortcode Options

A legacy feed reads the options in these tables. The plugin reads each option from the shortcode first and from the plugin’s settings when the shortcode leaves it out.

Feed Source Options

These options choose which posts the feed shows. Of these options, the free version reads only id and user. This means it shows posts from a connected account.

Hashtag and tagged feeds require an Instagram Business profile. To show posts from a user feed that also have a certain hashtag, use the includewords option.

Option	What it does	Accepted values	Free 6.15.1	Instagram Feed Pro
type	The kind of feed.	user, hashtag, tagged or mixed. A mixed feed combines a user feed with a hashtag or tagged feed.	No	Plus and up for hashtag and mixed, Elite for tagged
id	The connected account to show posts from. Separate several accounts with commas.	The username or user ID of a connected account	Yes	Basic and up
user	Another way to name the connected account. It does the same job as id for a user feed.	The username or user ID of a connected account	Yes	Basic and up
hashtag	The hashtags to show posts for. Separate several hashtags with commas.	One or more hashtags	No	Plus and up
tagged	The accounts whose tagged posts to show. Separate several accounts with commas.	The username of a connected account	No	Elite
order	The order of hashtag posts.	top or recent	No	Plus and up

Layout and Size Options

These options set the layout and size of the feed, the number of posts, and the number of columns.

Option	What it does	Accepted values	Free 6.15.1	Instagram Feed Pro
layout	How posts are arranged.	grid, carousel, masonry or highlight	No	Basic and up
width	The width of the feed.	A number	Yes	Basic and up
widthunit	The unit of the feed width.	px or %	Yes	Basic and up
widthresp	Makes the feed width responsive. The feed then fills the full width of mobile screens.	true or false	Yes	Basic and up
height	The height of the feed.	A number	Yes	Basic and up
heightunit	The unit of the feed height.	px or %	Yes	Basic and up
background	The background color of the feed.	A hex color code	Yes	Basic and up
class	A CSS class added to the feed container.	A class name	Yes	Basic and up
num	The number of posts to show at first.	A number	Yes	Basic and up
nummobile	The number of posts to show at first on mobile screens.	A number	Yes	Basic and up
cols	The number of columns.	A number	Yes	Basic and up
colsmobile	The number of columns on mobile screens.	A number	Yes	Basic and up
colstablet	The number of columns on tablets.	A number	Yes	Basic and up
disablemobile	Turns off the mobile layout.	true or false	Yes	Basic and up
imagepadding	The space around each post.	A number	Yes	Basic and up
imagepaddingunit	The unit of the space around each post.	px or %	Yes	Basic and up
apinum	The number of posts to request from the API at a time. The plugin requests the larger of this number and the number of posts it needs to show.	A number	Yes	Basic and up
offset	The number of posts to skip at the start of the feed.	A number	No	Plus and up

Carousel Options

These options apply when layout is carousel.

Option	What it does	Accepted values	Free 6.15.1	Instagram Feed Pro
carousel	Turns the feed into a carousel.	true or false	No	Basic and up
carouselrows	The number of rows in the carousel.	1 or 2	No	Basic and up
carouselloop	Whether the carousel loops through the posts or rewinds to the first post at the end.	rewind or infinity	No	Basic and up
carouselarrows	Shows arrows to move through the carousel.	true or false	No	Basic and up
carouselpag	Shows pagination below the carousel.	true or false	No	Basic and up
carouselautoplay	Moves the carousel on its own.	true or false	No	Basic and up
carouseltime	The time between slides when autoplay is on.	A number of milliseconds	No	Basic and up

Highlight Options

These options apply when layout is highlight.

Option	What it does	Accepted values	Free 6.15.1	Instagram Feed Pro
highlighttype	How posts are chosen for highlighting.	pattern, hashtag or id	No	Basic and up
highlightpattern	How often a post is highlighted.	A number	No	Basic and up
highlightoffset	The post where the highlight pattern starts.	A number	No	Basic and up
highlighthashtag	Highlights posts that use these hashtags.	One or more hashtags	No	Basic and up
highlightids	Highlights these posts.	Post IDs	No	Basic and up

Post Options

These options control the order of posts, the type of posts, the image size, the lightbox, and where each post links.

Option	What it does	Accepted values	Free 6.15.1	Instagram Feed Pro
sortby	How posts are sorted.	none (newest first) or random. Instagram Feed Pro also accepts likes.	Yes	Basic and up
imageres	The size of the post images.	auto, thumb, medium or full	Yes	Basic and up
media	Which types of posts to show.	all, photos or videos	Yes	Basic and up
videotypes	Which video types to show when the feed includes videos.	regular, reels or both separated by a comma	Yes	Basic and up
disablelightbox	Turns off the lightbox popup.	true or false	No	Basic and up
captionlinks	Links each post to the URL in its caption instead of to Instagram.	true or false	No	Basic and up

Lightbox Comments and Hover Options

These options control the comments in the lightbox and what shows when a visitor hovers over a post.

Option	What it does	Accepted values	Free 6.15.1	Instagram Feed Pro
lightboxcomments	Shows comments in the lightbox.	true or false	No	Basic and up
numcomments	The number of comments to show, starting with the most recent.	A number	No	Basic and up
hovercolor	The background color when a visitor hovers over a post.	A hex color code	No	Basic and up
hovertextcolor	The text and icon color when a visitor hovers over a post.	A hex color code	No	Basic and up
hoverdisplay	What shows when a visitor hovers over a post. Separate several values with commas.	username, date, instagram, location, caption or likes	No	Basic and up

Header Options

These options control the feed header.

Option	What it does	Accepted values	Free 6.15.1	Instagram Feed Pro
showheader	Shows or hides the header.	true or false	Yes	Basic and up
headerstyle	The header style.	standard, boxed, centered or text	No	Basic and up
headersize	The size of the header.	small, medium or large	Yes	Basic and up
headercolor	The color of the header text.	A hex color code	Yes	Basic and up
headerprimarycolor	The primary color of the boxed header.	A hex color code	No	Basic and up
headersecondarycolor	The secondary color of the boxed header.	A hex color code	No	Basic and up
headeroutside	Shows the header outside the scrollable area of a feed with a set height.	true or false	Yes	Basic and up
headersource	The connected account the header shows, by username or user ID.	A username or user ID	Yes	Basic and up
showbio	Shows the bio in the header.	true or false	Yes	Basic and up
custombio	Shows your own text as the bio.	Text	Yes	Basic and up
customavatar	Shows your own image as the avatar.	The full URL of an image	Yes	Basic and up
showfollowers	Shows the follower count in the header.	true or false	No	Basic and up
stories	Includes the account’s stories in the header when it has them.	true or false	No	Basic and up
storiestime	How long each story image shows. The plugin uses at least 500. When the option is empty, it uses 5000.	A number of milliseconds	No	Basic and up

Caption, Likes, and Comments Options

These options control the captions and the likes and comments under each post.

Option	What it does	Accepted values	Free 6.15.1	Instagram Feed Pro
showcaption	Shows the caption of each post.	true or false	No	Basic and up
captionlength	The number of characters to show in the caption.	A number	No	Basic and up
captioncolor	The color of the caption text.	A hex color code	No	Basic and up
captionsize	The size of the caption text.	A number	No	Basic and up
showlikes	Shows the likes and comments.	true or false	No	Basic and up
likescolor	The color of the likes and comments.	A hex color code	No	Basic and up
likessize	The size of the likes and comments.	A number	No	Basic and up

Load More and Follow Button Options

These options control the Load More button and the Follow on Instagram button.

Option	What it does	Accepted values	Free 6.15.1	Instagram Feed Pro
showbutton	Shows the Load More button.	true or false	Yes	Basic and up
buttoncolor	The background color of the Load More button.	A hex color code	Yes	Basic and up
buttontextcolor	The text color of the Load More button.	A hex color code	Yes	Basic and up
buttontext	The text on the Load More button.	Text	Yes	Basic and up
showfollow	Shows the Follow on Instagram button.	true or false	Yes	Basic and up
followcolor	The background color of the Follow on Instagram button.	A hex color code	Yes	Basic and up
followtextcolor	The text color of the Follow on Instagram button.	A hex color code	Yes	Basic and up
followtext	The text on the Follow on Instagram button.	Text	Yes	Basic and up
autoscroll	Loads more posts when a visitor scrolls down the page.	true or false	No	Basic and up
autoscrolldistance	How far from the end of the feed the next posts start to load. The plugin uses at least 20.	A number	No	Basic and up

Post Filtering and Moderation Options

These options choose which posts to show or hide.

Option	What it does	Accepted values	Free 6.15.1	Instagram Feed Pro
includewords	Shows only posts with these words or hashtags in the caption.	Words or hashtags separated by commas	No	Plus and up
excludewords	Hides posts with these words or hashtags in the caption.	Words or hashtags separated by commas	No	Plus and up
hidephotos	Hides these posts.	Post IDs separated by commas	No	Plus and up
whitelist	Shows only the posts in a saved list of approved posts.	The name of the list	No	Plus and up
moderationmode	Shows the Moderation Mode link on the front end of the site, where you pick which posts to show or hide. Only users who can edit posts see the link.	true or false	No	Plus and up

Caching and Other Options

These options control caching, images, and the rest of the feed.

Option	What it does	Accepted values	Free 6.15.1	Instagram Feed Pro
permanent	Keeps a permanent copy of the feed so the plugin never looks for new posts.	true or false	No	Basic and up
cachetime	Caches the feed’s page for this many minutes. The plugin uses at least 1.	A number of minutes	Yes	Basic and up
resizeprocess	When the plugin resizes post images. With page it resizes them while the page loads. With background, the plugin’s default, it resizes them in a separate request after the feed loads.	page or background	Yes	Basic and up
customtemplates	Replaces the feed’s default HTML with custom templates from your theme folder. Your theme must have the templates for this option to work.	true or false	Yes	Basic and up
mediavine	Turns on the Mediavine integration.	true or false	No	Basic and up

That’s it! You now know which shortcode options Instagram Feed accepts, which ones the free version reads, and which license level includes each one. To learn how a legacy feed works, see our guide to Instagram legacy feeds.

Frequently Asked Questions

Below, we’ve answered some of the most common questions about Instagram Feed shortcode options.