Soliloquy Documentation
Documentation, Reference Materials, and Tutorials for Soliloquy
Instagram Addon
The Instagram Addon will allow you to easily create a slider directly from your Instagram images! We’ll walk you through each step on how to create an Instagram slider.
Requirements
- Master, Agency, Developer or Multi Soliloquy license. You can read how to upgrade to one of these licenses here.
- WordPress 4.8+
Installation
Please follow our instructions on how to install and activate addons.
In this instance, you’ll be activating the Soliloquy Instagram Addon.
Setup
Step 1 – Authenticate the Instagram Account for Your Site
Before you can begin creating Instagram sliders, you’ll first need to let Instagram know you’re giving Soliloquy to use your Instagram images.
Click the Soliloquy » Settings and select the Instagram tab.
Then select the Click here to Authenticate Soliloquy with Instagram button.
Next, you’ll be prompted to login to your Instagram account if you’re not already logged in.
Click the Authorize button. This connects Soliloquy to your Instagram account.
You’ll then see a success message on your Soliloquy Settings page.
Step 2 – Create your slider
Your first step is to create a new slider or edit an existing one. You can follow along with our documentation for creating your first slider.
Step 3 – Select the External Slider tab
Next, click the External Slider tab from inside Soliloquy and select the Instagram icon.
Step 4 – Configure your slider settings
Your next step is to configure the slider settings specific to Instagram. If you’d like the images to link directly to your Instagram page, click the Link to Instagram Location? checkbox.
Step 5 – Publish or Update your gallery
Finally, click Publish or Update on your slider to save the changes.
And that’s it! You’ve now created your first Instagram slider! Would you like to see what other slider types you can create? Take a look at our documentation on the How to use the Dynamic Addon.
FAQs
Q: Why can’t I set my image sizes?
A: When creating an Instagram gallery, the images only have reading access. This means Soliloquy can only see the images from your Instagram and use the image URLs. Soliloquy doesn’t have the permissions needed to create cropped image sizes for the slider.
Q: How many images can I use at once?
A: At this time the Instagram API paginates image requests in batches of 33 images, and it is only possible to populate your slider with a maximum of 33 Instagram images.
Changelog
2.3.12 (July 28, 2026)
- Fixed: The Instagram account connection callback now requires administrator permission.
- Fixed: The returned access token and account details are now sanitized before being saved.
- Fixed: The slider type and resolution dropdowns are now escaped.
- Improved: On multisite, the addon now uses the standard WordPress site lookup instead of querying the sites table directly.
2.3.11 (May 19, 2026)
- Added: Option to show Instagram captions on slider slides, plus a new "Caption Length (Words)" setting.
- Added: Instagram slide links now point back to the original Instagram post, with support for opening in a new window.
- Added: Cache flushing action in the Instagram metabox.
- Changed: Updated internal links to use https:// for soliloquywp.com.
2.3.9 (May 3, 2024)
- Fixes: Warning for PHP 8.1.
- Fixed: Updated request handler.
2.3.8 (March 25, 2024)
- Improved: Instagram endpoint.
2.3.6 (April 14, 2022)
- Fixes: PHP 8 Error.
2.3.5 (August 7, 2020)
- Fixes: IG appearing on other slider issue resolved.
2.3.4 (July 28, 2020)
- Fixes: Remove testing code.
2.3.3 (July 25, 2020)
- Fixes: Resolves fatal error.
2.3.2 (July 8, 2020)
- Fixes: Broken Link to Documentation.
- Fixes: Resolves issue with legacy Instagram account removal.
2.3.1 (June 23, 2020)
- Fixes: Update Instagram API.
2.2.3 (December 10, 2018)
- Fixes: Auth issues
2.2.2 (August 31, 2016)
- Removed: Depricated Instagram API calls
2.2.1 (June 21, 2016)
- Fixed bug that might cause plugin to deactivate on update
2.2.0 (June 21, 2016)
- UI Refresh
2.1.1 (October 22, 2015)
- Added: Hide crop option when using Instagram sliders, as we can’t crop remote images
- Added: Option to show photos liked by authenticated Instagram user
- Added: Option to show photos of any user by tag
- Fixed bug with authentication when using wrong post type and settings page name.
2.1.0
- Soliloquy and the Addons are now at v2! Please read the upgrade guide: http://soliloquywp.com/soliloquy-v2-upgrade-guide/
2.0.1
- Fixed bug where settings page was referenced incorrectly to authenticate to Instagram.
2.0.0
- Say hello to version 2.0!