PHPackages                             outstand/instagram-feed - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. outstand/instagram-feed

ActiveWordpress-plugin

outstand/instagram-feed
=======================

1.0.0(2mo ago)216↓100%GPL-3.0-or-laterPHPPHP ^8.2

Since Mar 6Pushed 1mo agoCompare

[ Source](https://github.com/outstand-labs/outstand-instagram-feed)[ Packagist](https://packagist.org/packages/outstand/instagram-feed)[ RSS](/packages/outstand-instagram-feed/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (2)Dependencies (7)Versions (2)Used By (0)

Outstand Instagram Feed
=======================

[](#outstand-instagram-feed)

> Display Instagram posts using a customizable Gutenberg block with list and grid layouts.

Description
-----------

[](#description)

A WordPress plugin that connects to the Instagram API to display your Instagram posts in the block editor. It handles OAuth authentication, automatic token refresh, and provides modular blocks for media and captions with full layout and styling controls.

The icons are from [Themify Icons](https://themify.me/themify-icons).

[![Outstand Instagram Feed](assets/demo.gif)](assets/demo.gif)

Features
--------

[](#features)

- **OAuth Authentication**: Connects to the Instagram API with automatic long-lived token refresh
- **List and Grid Layouts**: Choose how your feed is displayed
- **Modular Blocks**: Separate blocks for media, captions, and post templates
- **Full Styling Support**: Colors, typography, spacing, borders, and overlay controls
- **Built-in Caching**: 5-minute transient cache for optimal performance

Installation
------------

[](#installation)

### Manual Installation

[](#manual-installation)

1. Download the plugin ZIP file from the GitHub repository.
2. Go to Plugins > Add New > Upload Plugin in your WordPress admin area.
3. Upload the ZIP file and click Install Now.
4. Activate the plugin.

### Install with Composer

[](#install-with-composer)

To include this plugin as a dependency in your Composer-managed WordPress project:

1. Add the plugin to your project using the following command:

```
composer require outstand/instagram-feed
```

2. Run `composer install` to install the plugin.
3. Activate the plugin from your WordPress admin area or using WP-CLI.

Setup
-----

[](#setup)

> You'll connect your Instagram Business or Creator account to your website using a Facebook App. This allows the plugin to fetch and display your Instagram feed securely.

### Account Requirements

[](#account-requirements)

- Your Instagram account must be a **Business** or **Creator** account
- To convert your account: [How to switch to a professional Instagram account](https://help.instagram.com/502981923235522)

### Step 1: Create App

[](#step-1-create-app)

> All Instagram API access goes through the Facebook Developers platform. You'll create a Facebook App that connects to your Instagram Business or Creator account.

1. Go to [Facebook Developers Portal](https://developers.facebook.com/apps/) and click **Create App**
2. Enter your app name (e.g., "My Website Social Feed" or "Company Social Media") and your contact email address [![App details](assets/create-app-01.png)](assets/create-app-01.png)
3. Click **Next**
4. Under **Filter by**, choose **Others**, then select **Other** as the use case and click **Next**[![App use case](assets/create-app-02.png)](assets/create-app-02.png)
5. Select **Business** as app type and click **Next**[![App type](assets/create-app-03.png)](assets/create-app-03.png)
6. Click **Create app**[![App review](assets/create-app-04.png)](assets/create-app-04.png)

### Step 2: Configure App

[](#step-2-configure-app)

1. Go to **App settings** > **Basic**:
    - Add your **Privacy Policy URL** and **Terms of Service URL**
    - Add your website domain to **App domains**: `yourdomain.com`
    - Click **Save changes**[![App settings](assets/configure-app-01.png)](assets/configure-app-01.png)
2. In the app dashboard, under **Products**, click **Set up** in **Instagram**[![App dashboard](assets/configure-app-02.png)](assets/configure-app-02.png)
3. Copy your **Instagram App ID** and **Instagram App Secret** (Do NOT use the credentials from **App settings** > **Basic**) [![App ID and secret](assets/configure-app-03.png)](assets/configure-app-03.png)
4. Click **Set up** under **Set up Instagram business login**
5. Add the following **Redirect URL** (replace yourdomain.com with your site's domain): `https://yourdomain.com/outstand-instagram-feed/oauth-callback`[![Redirect URL](assets/configure-app-04.png)](assets/configure-app-04.png)
6. Click **Save**
7. Go to **App Roles** > **Roles**
8. Click **Add People**[![Add people](assets/configure-app-05.png)](assets/configure-app-05.png)
9. Select **Instagram Tester** role
10. Search for the account connected to your Instagram and click **Add**[![Select Instagram tester](assets/configure-app-06.png)](assets/configure-app-06.png)
11. The person must accept the invitation:
    - Go to Instagram
    - Go to **Settings** > **Apps and websites** > **Tester Invites**
    - Accept the invitation

### Step 3: Configure Plugin

[](#step-3-configure-plugin)

1. Go to **Settings > Outstand Instagram Feed** in your WordPress admin
2. Enter your **Instagram App ID** and **Instagram App Secret** and click **Save**
3. Click **Connect Instagram Account**
4. You will be redirected to Instagram where you can log in with your username and password
5. After login, you will see a permissions window. The only permission required is **View profile and access media**. All others you can leave unchanged or toggle off.
6. Click **Allow**
7. You'll be redirected back to WordPress. Your connection will appear as **Connected** in the plugin settings.

### Step 4: Add the Block

[](#step-4-add-the-block)

1. In the block editor, search for "Instagram Feed"
2. Add the block to your page or post
3. Configure the number of posts to display
4. Choose your preferred layout (list or grid)

Usage
-----

[](#usage)

### Instagram Feed

[](#instagram-feed)

The main block controls the overall feed settings:

- **Number of Posts**: Set how many Instagram posts to display (1-50)
- **Layout**: Choose between list and grid layouts
- **Alignment**: Support for wide and full-width alignments

### Child Blocks

[](#child-blocks)

- **Post Template**: Container for individual Instagram posts with full layout and styling support
- **Post Media**: Displays the Instagram image with link, dimension, overlay, border, and shadow controls
- **Post Caption**: Shows the post caption with heading level, alignment, link, and typography options

Requirements
------------

[](#requirements)

- WordPress 6.7 or higher
- PHP 8.2 or higher
- Instagram **Business** or **Creator** account
- Facebook Developer account with Instagram product configured

Changelog
---------

[](#changelog)

All notable changes to this project are documented in [CHANGELOG.md](https://github.com/pixelalbatross/outstand-instagram-feed/blob/main/CHANGELOG.md).

License
-------

[](#license)

This project is licensed under the [GPL-3.0-or-later](https://spdx.org/licenses/GPL-3.0-or-later.html).

###  Health Score

40

—

FairBetter than 88% of packages

Maintenance89

Actively maintained with recent releases

Popularity11

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity46

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

65d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/42eed63db46bd6dc4df88e37095ad4f8aeacfcc63f68e7e11c637eb9ec18a652?d=identicon)[s3rgiosan](/maintainers/s3rgiosan)

---

Top Contributors

[![s3rgiosan](https://avatars.githubusercontent.com/u/499982?v=4)](https://github.com/s3rgiosan "s3rgiosan (6 commits)")

---

Tags

block-editorgutenbergwordpresswordpress-plugin

###  Code Quality

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/outstand-instagram-feed/health.svg)

```
[![Health](https://phpackages.com/badges/outstand-instagram-feed/health.svg)](https://phpackages.com/packages/outstand-instagram-feed)
```

###  Alternatives

[humbug/box

Fast, zero config application bundler with PHARs.

1.3k801.5k68](/packages/humbug-box)[vaimo/composer-patches

Applies a patch from a local or remote file to any package that is part of a given composer project. Patches can be defined both on project and on package level. Optional support for patch versioning, sequencing, custom patch applier configuration and patch command for testing/troubleshooting added patches.

2994.3M15](/packages/vaimo-composer-patches)[mglaman/composer-drupal-lenient

1317.4M15](/packages/mglaman-composer-drupal-lenient)[drupal/core-composer-scaffold

A flexible Composer project scaffold builder.

5341.9M445](/packages/drupal-core-composer-scaffold)[roots/wordpress-core-installer

A Composer custom installer to handle installing WordPress as a dependency

4115.6M19](/packages/roots-wordpress-core-installer)[drupal/core-project-message

Adds a message after Composer installation.

2122.6M172](/packages/drupal-core-project-message)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)