Instagram Feed Block

The Instagram Feed Block allows site builders to add Instagram feeds as blocks and control how content is displayed, including the number of posts, optional date-based and hashtag filtering, on a per block basis.

## ✨ Features

* Display Instagram posts from a connected Business or Creator account
* Add feeds as Drupal blocks (place anywhere via Layout Builder or Block UI)
* Configure number of posts per block
* Filter posts by:
* Custom date range
* Or “last X days” (e.g., last 7, 14, 30 days)
* Hashtag (shows only hashtags from account ID)
* Supports images, videos, and carousel posts
* Responsive grid layout
* Accessible markup with descriptive labels
* Gutenberg-compatible block settings, accessible through the editor
* Built-in caching for improved performance
* Lightweight — no external embeds or iframes

## ⚙️ Requirements

* Instagram Business or Creator account
* Facebook Developer App
* Instagram Graph API access
* Long-lived access token
* Key module

## 🔧 Configuration

1. Enter your Instagram Business Account ID
2. Provide a long-lived access token
3. Configure optional settings such as cache lifetime
4. Place the “Instagram Feed” block and customize display options per instance

## 🎯 Use cases

* Showcase recent social media content
* Highlight campaigns or events within a specific timeframe
* Display curated Instagram content, even for multiple accounts, across different site sections

## ⚠️ Limitations

* Requires an Instagram Business or Creator account
* API access is subject to Meta platform limitations
* Content is limited to posts accessible via the Instagram Graph API

## 🚀 Why use this module?

Unlike embed-based solutions, this module:

* Uses the official API
* Loads faster (no iframe embeds)
* Gives full control over display and filtering
* Integrates cleanly with Drupal’s block and caching systems and Gutenberg