=== Easy Social Feed - Social Photos Gallery and Post Feed for WordPress ===
Contributors: DaNish Ali, maltathemes, sjaved, freemius
Tags: Instagram feed, Facebook feed, YouTube feed, X feed, TikTok feed
Requires at least: 3.3
Tested up to: 7.1
Stable tag: 6.7.10
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Display **Instagram**, **Facebook**, **YouTube**, **X** and **TikTok** feeds in WordPress with responsive layouts, caching, shortcodes, Facebook blocks and widgets.

== Description ==

Easy Social Feed lets you display **Instagram**, **Facebook**, **YouTube**, **X** and **TikTok** content on your WordPress website.

Create responsive social media feeds with live customization, configurable layouts and simple embedding. Keep your website fresh with the latest content from your social accounts, showcase your work and encourage visitors to follow you.

https://www.youtube.com/watch?v=VB_qRtmXS6A

**Instagram** is supported prominently for professional Business and Creator accounts, with photos, videos, Reels and gallery content displayed directly on your website.

Each social module can be enabled or disabled independently, helping you load only the integrations your website uses.

### Get started in three steps

1. **Connect your account** — choose **Instagram**, **Facebook**, **YouTube**, **X** or **TikTok** and follow the connection flow.
2. **Customize your feed** — select a layout, adjust columns and spacing, and preview your changes.
3. **Add it to your website** — copy the generated shortcode and paste it into any compatible page, post, widget or page-builder element.

No coding is required for the setup.

[Instagram Feed Demo](https://easysocialfeed.com/my-instagram-feed-demo/?utm_source=wordpress.org&utm_medium=referral&utm_campaign=instagram_feed_demo) | [Facebook Feed Demo](https://easysocialfeed.com/custom-facebook-feed/?utm_source=wordpress.org&utm_medium=referral&utm_campaign=facebook_feed_demo) | [YouTube Feed Demo](https://easysocialfeed.com/custom-youtube-feed/?utm_source=wordpress.org&utm_medium=referral&utm_campaign=youtube_feed_demo) | [X/Twitter Feed Demo](https://easysocialfeed.com/custom-twitter-feed/?utm_source=wordpress.org&utm_medium=referral&utm_campaign=twitter_feed_demo) | [TikTok Feed Demo](https://easysocialfeed.com/custom-tiktok-feed/?utm_source=wordpress.org&utm_medium=referral&utm_campaign=tiktok_feed_demo)

### Why use Easy Social Feed?

- **Instagram**, **Facebook**, **YouTube**, **X** and **TikTok** feeds in one plugin
- Responsive layouts for desktop, tablet and mobile
- Live feed customization and preview
- Automatically keep your website content fresh when you publish on social media
- Showcase your latest work, products, videos and updates
- Encourage visitors to follow your social accounts
- Add social proof and real-time content to your website
- Keep visitors engaged without sending them away from your site
- Server-rendered social content for better accessibility and discoverability
- Semantic markup, crawlable links and structured data where supported
- Database caching to reduce repeated API requests
- Conditional loading of module assets
- Shortcode embedding for all modern feed modules
- **Facebook** block and widget support
- **Instagram** widget support
- Custom CSS controls for supported feeds
- Multiple feeds on different pages using separate feed shortcodes
- Consent-aware controls for remote media and embeds
- Free modules with clearly defined Pro upgrades

### Reviews

*"**This Plugin Rocks!** It was simple to install, connect my **Facebook** pages and add the widget. It looks beautiful on my page."* — [sayhi2lonnie](https://wordpress.org/support/topic/this-plugin-rocks-61/)

*"Easy to use as the description — awesome plugin and excellent support. It’s easy to set up and won’t affect the page speed."* — [WordPress.org review](https://wordpress.org/support/topic/easy-to-use-as-the-description/)

See more [Easy Social Feed reviews](https://wordpress.org/support/plugin/easy-facebook-likebox/reviews/?filter=5).

### Perfect for

Easy Social Feed is useful for:

- Businesses and local businesses
- **Instagram** creators and influencers
- Photographers, artists and portfolios
- Restaurants, hotels and events
- Online stores and product brands
- Bloggers and publishers
- Agencies managing client websites

### What is included in Free and Pro?

**Free features**

The free plugin includes:

- **Instagram** feeds from connected professional accounts
- **Facebook** Page feeds
- **YouTube** channel feeds
- **X/Twitter** account timelines
- **TikTok** feeds from your connected account
- Responsive Grid and Row layouts where available
- Feed headers and profile information where supported
- Captions, titles and post metadata
- Live feed customization
- Configurable post counts
- Caching and configurable refresh intervals
- Shortcode embedding
- **Facebook** blocks and widgets
- **Instagram** widgets
- Custom CSS controls where supported

**Pro features**

Pro features vary by module and plan and may include:

- Additional layouts such as Masonry, Carousel, Full-width and Half-width
- Load More and infinite scrolling
- Popup and lightbox media viewing
- Video playback options
- Stories and hashtag feeds for eligible **Instagram** connections
- Playlist and search feeds for **YouTube**
- Public **X/Twitter** accounts by username
- Multiple connected accounts and multifeed support where available
- Post-type filtering
- Visual moderation
- Shoppable links and custom post links
- Engagement statistics and comments
- Advanced popup galleries
- Additional **TikTok** row styles

### Instagram Feed

Display **Instagram** photos, videos, reels and gallery posts in a responsive WordPress feed.

Easy Social Feed supports **Instagram** Business and Creator accounts through supported Instagram and **Facebook** connection methods. You can customize the feed, generate a shortcode and display it anywhere on your website.

**Instagram Free features**

- Connect an eligible Instagram Business or Creator account
- Display photos, videos, reels and gallery content
- Responsive Grid layout
- Responsive Row layout
- Profile header and account information
- Follow button
- Captions and post metadata
- Configurable number of posts
- Live preview customization
- Separate feeds with individual shortcodes
- Caching and configurable refresh intervals
- Instagram widget support
- Custom CSS controls where supported

**Instagram Pro features**

- Masonry layout
- Carousel layout
- Full-width layout
- Half-width layout
- Load More pagination
- Popup and lightbox viewing
- Stories support for eligible connections
- Hashtag feeds
- Top and Recent hashtag content
- Visual moderation
- Shoppable links and custom post links
- Comments and replies in the lightbox where available
- Multifeed support
- Wave Row style with staggered posts
- Local media support where available

Instagram advanced features depend on the connection type and Meta API availability. Hashtag feeds and some advanced features require the Facebook Page-backed connection method.

[Instagram Feed Demo](https://easysocialfeed.com/my-instagram-feed-demo/?utm_source=wordpress.org&utm_medium=referral&utm_campaign=instagram_feed_demo)

*"**Much better than the others** — I’m really happy with this. It’s better than the other plugins I’ve tried that offer the same thing."* — [sarahtaylor777](https://wordpress.org/support/plugin/easy-facebook-likebox/reviews/?filter=5)

### Facebook Feed

Display posts from your **Facebook** Page, including text, images, videos, links, albums and supported events.

**Facebook Free features**

- Connect Facebook Pages through the supported Meta connection flow
- Display Page posts
- Half-width layout
- Full-width layout
- Thumbnail layout
- Row layout
- Feed header controls
- Caption and post content controls
- Share buttons where supported
- Read More links
- Caching
- Shortcodes
- Facebook blocks
- Facebook widgets

**Facebook Pro features**

- Grid layout
- Masonry layout
- Carousel layout
- Load More pagination
- Post-type filtering
- Event feed features
- Visual moderation
- Multiple-page multifeed
- Advanced popup and media gallery
- Featured post controls
- Additional media and engagement features

Facebook features depend on the permissions provided by Meta and the connected Page.

[Facebook Feed Demo](https://easysocialfeed.com/custom-facebook-feed/?utm_source=wordpress.org&utm_medium=referral&utm_campaign=facebook_feed_demo)

### Facebook Page Plugin

Embed the official **Facebook** Page Plugin on your website using a shortcode.

**Facebook Page Plugin features**

- Responsive Facebook Page display
- Custom width and height
- Page header and profile information
- Optional profile photos
- Timeline, Events and Messages tabs (Pro)
- Multiple language and localization options
- Shortcode-generated configuration

The Facebook Page Plugin loads Facebook content in an official iframe. Unlike the modern Facebook Feed, it does not add server-rendered feed content for SEO, AEO or GEO.

### YouTube Feed

Display videos from your connected **YouTube** channel in a responsive feed.

Connect your channel through Google OAuth, create a feed and embed it using a shortcode.

**YouTube Free features**

- Secure Google OAuth connection
- Connected channel feeds
- Grid layout
- Row layout
- Channel header controls
- Video thumbnails, titles and dates
- Responsive column and spacing controls
- Caching with configurable refresh intervals
- Per-feed Custom CSS
- Shortcode embedding
- Local thumbnail handling where available

**YouTube Pro features**

- Playlist feeds
- Search feeds
- Carousel layout
- Full-width layout
- Half-width layout
- Masonry layout
- Load More pagination
- Popup and lightbox video gallery
- Autoplay and mute controls
- Video descriptions and statistics
- Comments in the popup where available
- Multiple-account and multifeed features where supported
- Visual moderation

[YouTube Feed Demo](https://easysocialfeed.com/custom-youtube-feed/?utm_source=wordpress.org&utm_medium=referral&utm_campaign=youtube_feed_demo)

### X/Twitter Feed

Display an **X/Twitter** timeline on your WordPress website with responsive layouts and customizable post cards.

Connect your own account through OAuth. Pro users can also add eligible public **X** accounts by username.

**X/Twitter Free features**

- OAuth connection for your own account
- Timeline layout
- Row layout
- Responsive feed controls
- Account header and statistics
- Tweet content and media
- Caching
- Shortcode embedding
- Per-feed Custom CSS

**X/Twitter Pro features**

- Public X accounts by username
- Grid layout
- Masonry layout
- Carousel layout
- Full-width and Half-width layouts
- Wave row style
- Load More pagination
- Popup and media lightbox
- Video and image galleries
- Multiple connected accounts
- Multifeed support
- Visual moderation where available

Public-account support depends on the X API and the availability of the configured service.

[X/Twitter Feed Demo](https://easysocialfeed.com/custom-twitter-feed/?utm_source=wordpress.org&utm_medium=referral&utm_campaign=twitter_feed_demo)

### TikTok Feed

Display videos from your connected **TikTok** account in responsive Grid and Row layouts.

**TikTok** feeds use the supported TikTok Login Kit and Display API connection flow and display videos belonging to the connected account.

**TikTok Free features**

- Secure TikTok account connection
- Connected-account video feeds
- Grid layout
- Row layout
- Profile header controls
- Video covers and metadata
- Responsive column and spacing controls
- Local cover images where available
- Caching with configurable refresh intervals
- Per-feed Custom CSS
- Shortcode embedding

**TikTok Pro features**

- Wave row style
- Load More pagination
- Infinite scrolling
- Popup and lightbox video viewing
- Engagement information where available
- Additional premium feed controls

TikTok availability depends on TikTok account eligibility, API access and approved permissions. Public TikTok username feeds are not included.

[TikTok Feed Demo](https://easysocialfeed.com/custom-tiktok-feed/?utm_source=wordpress.org&utm_medium=referral&utm_campaign=tiktok_feed_demo)

### Embedding options

Modern Easy Social Feed modules can be embedded using shortcodes: `[esf_facebook_feed]`, `[esf_instagram_feed]`, `[esf_youtube_feed]`, `[esf_twitter_feed]`, `[esf_tiktok_feed]`.

The plugin also supports Facebook Gutenberg blocks, Facebook widgets, the Facebook Page Plugin shortcode, Instagram widgets, shortcode fields in compatible page builders, and PHP embedding for supported modules.

Generate the shortcode from the feed editor, copy it and paste it into a page, post, widget or compatible page-builder shortcode element.

### Performance, caching and privacy

Easy Social Feed uses database caching and configurable refresh intervals to reduce repeated requests to social platform APIs.

Depending on the module and settings:

- Feed assets load only when a feed is displayed
- Media may be served locally
- Remote media and embeds can be delayed until consent
- Zero-third-party options can prevent remote media or embed requests
- You can clear the cache globally or for individual feeds where supported

Social platforms may still receive requests when their content or official embeds are loaded. Website owners are responsible for configuring their consent tools, privacy policy and regional compliance settings.

The plugin includes integrations for several consent and cookie-management plugins, including: Real Cookie Banner, GDPR Cookie Compliance, Cookie Notice, GDPR Cookie Consent, CookieYes, Cookiebot, Complianz, Borlabs Cookie, and WPConsent.

== Installation ==
1. Install Easy Social Feed from the WordPress Plugins screen.
2. Activate the plugin.
3. Open Easy Social Feed in the WordPress dashboard.
4. Enable the modules you want to use.
5. Connect the relevant social account.
6. Create and customize a feed.
7. Copy the generated shortcode.
8. Paste the shortcode into a page, post, widget or compatible page-builder element.

Connection requirements vary by platform. Instagram requires an eligible professional account. Facebook requires an eligible Page and Meta permissions. YouTube requires Google account authorization. X and TikTok require supported OAuth/API access.

== Frequently Asked Questions ==
= Which social platforms does Easy Social Feed support? =

Easy Social Feed supports Instagram, Facebook, YouTube, X/Twitter and TikTok through separate modules.

= Can I use only one social network? =

Yes. Each module can be enabled or disabled independently from the Easy Social Feed hub.

= How do I display an Instagram feed? =

Connect an eligible Instagram Business or Creator account, create a feed, customize it and paste the generated Instagram shortcode into your website.

= How do I add an Instagram feed to a WordPress page? =

Create an Instagram feed in Easy Social Feed, copy its shortcode and paste it into a WordPress page or post. You can also use the Instagram widget in a widget-ready area.

= Can I display Instagram Reels and gallery posts? =

Yes. Eligible Instagram photos, videos, Reels and gallery posts can be displayed in your feed. Content availability depends on Instagram permissions and API rules.

= Can I display multiple Instagram accounts? =

Separate Instagram feeds can be created for connected accounts. Combining multiple accounts into one feed is available in Pro where supported.

= Does Easy Social Feed include an Instagram Gutenberg block? =

The modern Instagram module currently uses shortcodes and the Instagram widget for embedding. Facebook has dedicated block support. Use the generated shortcode in the WordPress editor or a compatible page builder.

= Do I need an Instagram Business or Creator account? =

Yes. The supported modern Instagram connection methods require an eligible professional Instagram account.

= Can I display Instagram hashtag feeds? =

Hashtag feeds are available in Pro for eligible Facebook Page-backed Instagram connections. Availability depends on Meta permissions and API access.

= Can I display Instagram Stories? =

Stories are available in Pro for eligible connections. Story availability and expiry are controlled by Instagram and Meta API rules.

= Can I display Facebook Page posts? =

Yes. Connect an eligible Facebook Page and create a Facebook feed using the modern Facebook module.

= Can I display a YouTube playlist or search feed? =

Playlist and search feeds are Pro features. Free accounts can display connected YouTube channel feeds.

= Can I display a public X/Twitter account? =

Public X/Twitter account feeds are available in Pro where the required API service is available. Free accounts can connect and display their own eligible account.

= Can I display any TikTok username? =

No. TikTok feeds currently display videos from the connected TikTok account and do not provide arbitrary public username feeds.

= Does the plugin support multiple feeds? =

Yes. You can create separate feeds and place them on different pages using their generated shortcodes. Feature and account limits vary by module and plan.

= Does the plugin support page builders? =

Shortcodes can be used in compatible page-builder shortcode or text elements. Exact support depends on the page builder and module.

= Does the plugin cache social content? =

Yes. Feed responses are cached to reduce repeated API requests. Cache duration can be configured where supported, and caches can be cleared from the plugin settings.

= Is Easy Social Feed GDPR compliant? =

The plugin provides consent-aware controls, supported consent-plugin integrations and optional zero-third-party behavior. Website owners remain responsible for configuring consent settings and maintaining their privacy notices.

= Will social feeds improve my SEO? =

The plugin provides server-rendered markup, semantic content, crawlable links and structured data where supported. These features can improve content discoverability, but no plugin can guarantee search rankings or AI visibility.

== Screenshots ==

== Changelog ==

= 6.7.10 =
* Fixed: WordPress.org package was missing required shared frontend files, which caused a fatal error on install.

= 6.7.9 =
* Added: TikTok Feed module — connect your account, create feeds (Grid & Row free; Wave style & popup lightbox in Pro), and embed with shortcode.
* Added: Modern Facebook Feed module with a new dashboard (accounts, feeds, live preview) and a migration path from the legacy module.
* Added: Visual moderation (Pro) for Facebook, YouTube, and X/Twitter feeds to show or hide posts.
* Added: Row layout for YouTube and X/Twitter feeds.
* Added: Carousel layout support across modern feed modules.
* Added: Multifeed (Pro) for Facebook, Instagram, YouTube, and X/Twitter — combine multiple accounts in one feed.
* Added: YouTube lightbox comments.
* Added: Reconnect alert emails when a social account token expires or disconnects (enabled by default; disable under each module’s Settings).
* Added: GDPR zero-third-party mode and improved feed caching.
* Improved: Instagram legacy-to-modern migration guidance, follow button, and display panels.
* Added: Load More infinite Scroll (Pro).
* Fixed: Minor issues.

= 6.7.8 =
* Fixed: Critical error when editing the Instagram feed widget in Customizer with the modern Instagram module.
* Improved: lightbox controls theme compatibility.
* Improved: Instagram avatar and stories thumbnail sizing with page builders.
* Fixed: Minor issues.

= 6.7.7 =
* Added: Modern Instagram Feed module with a new dashboard (accounts, feeds, live preview), aligned with YouTube and X/Twitter.
* Added: Modern Easy Social Feed main (hub) page and global Settings page for managing modules and plugin-wide options.
* Improved: Legacy Instagram module is now deprecated; users can still switch between modern and legacy while migrating.
* Added: Feed size controls per device for X/Twitter and YouTube feeds.
* Added: Media aspect ratio option for X/Twitter and YouTube feeds to control how post media is framed.
* Fixed: Minor issues in the X/Twitter and YouTube modules.

= 6.7.6 =
* Improved: YouTube channel header banner height increased so the channel artwork looks more prominent in the feed.
* Added: X / Twitter Feed module with README documentation and Translation tab support for Twitter feed labels.
* Fixed: When a connected account assigned to a feed is deleted, the plugin now shows a notice and auto-assigns another available account where possible.
* Added: New first-run onboarding wizard to simplify setup across modules.
* Improved: Connection handoff now redirects users to module pages, with auto-open connect flow for Facebook and Instagram.

= 6.7.5 =
* Added: Feed language setting in General settings so you can choose which language Facebook and Instagram use for their built‑in text (e.g. “X created an event”, “X shared a link”). Default uses your site language; feed cache is cleared when you change the language
* Improved: General settings intro and descriptions for clarity and to cover all modules (Facebook, Instagram, YouTube)
* Added: AI-powered translation autofill on the Translation tab (Pro) to automatically translate and fill feed labels into your selected language, with a one-click reset back to the original English defaults
* Added: YouTube Feed module with a modern dashboard to connect your channel, create feeds and embed them using shortcode
* Added: YouTube feed customization options including layout, header display, per-feed Custom CSS and cache duration controls
* Added: YouTube performance improvements including serving thumbnails locally when possible (channel and video thumbnails)
* Added: YouTube Pro options including Load More and Popup / Lightbox video gallery settings
* Fixed: Facebook and Instagram duplicate issue.

= 6.7.4 =
* Added: General tab under Settings (Easy Social Feed > Settings) with option to preserve or remove all plugin data when the plugin is deleted
* Fixed: Instagram Business connection failing due to deprecated field in the Graph API, replaced with supported fields to restore authentication
* Fixed: Minor issues

= 6.7.3 =
* Added: GDPR option for Facebook and Instagram feeds (Automatic, Always Enabled, or Disabled) to work with popular cookie consent plugins
* Added: Translation tab under Settings to globally customize static frontend text (buttons, labels, messages) for both Facebook and Instagram feeds
* Improved: Frontend string handling with request-level caching for faster translation lookups
* Fixed: Minor issues

= 6.7.2 =
* Fixed: Instagram Hashtag issue
* Fixed: Minor issues
* Added: Custom filter to translate API error messages
* Tested: Upto 6.9

= 6.7.1 =
* Fixed: Media lightbox not remembering customizer settings
* Fixed: Lightbox image size rendering issues
* Fixed: Instagram "Load More" conflict with Moderate tab
* Fixed: Facebook post hashtag display issue
* Added: Filters to customize Facebook and Instagram post date/time display formats
* Improved: Added pre-connection check to ensure Facebook Page is linked to Instagram account before using Business Advanced connection
* Improved: Load more feature to avoid rare duplicate issue

= 6.6.9 =
* Added: New Facebook connection modal that informs users about required permissions and Business Manager settings before connecting their account
* Added: New Instagram two-step connection flow with Business Basic and Business Advanced options, providing clear guidance on permissions and requirements for each connection type
* Improved: Enhanced user experience with detailed permission explanations and helpful links for Instagram account setup and Facebook Page connections
* Updated: Freemius SDK
* Fixed: Minor issues

= 6.6.8 =
* Fixed: Security vulnerability
* Fixed: Warnings in complete detail and minor issues

= 6.6.7 =
* Fixed: $datetime Fatal error

Older changelog entries are available on our website:
https://easysocialfeed.com/changelog

== Upgrade Notice ==

= 6.7.10 =
Major update: TikTok module, modern Facebook, Multifeed & moderation (Pro), new layouts for YouTube/X, and many UX/stability fixes. Recommended for all users.
