Getting started
On this page we explain the basic steps required to connect an Instagram
account, create a feed, and add it to your project. This guide assumes that
you've already
created a free account.
Connect to Instagram
We refer to connected Instagram accounts as "sources." All feeds have an associated source.
Navigate to the sources page and click on the + Add source button. You will see an option to connect either a Basic source or Advanced source. For now, let's connect a basic source.
related
Basic vs advanced sources
Notice
Due to a recently announced Instagram API change, only professional Instagram accounts can be connected to Behold. Learn more.If you have login access to the Instagram account:
- Click on the Open link button
- After being redirected to Instagram, click allow. Make sure all permissions are granted. It will say "optional" next to some requested permissions, but they are required for Behold to function.
- You should then see a loading screen, followed by your sources page with a new source added.
If you do not have login access to the Instagram account:
- Copy your unique auth link, displayed next to the Open link button
- Have the owner of the account visit that link. They can authorize the account without being logged in to Behold.
- Once they have completed authorization, their account will appear on your sources page
Tip
If the password for an Instagram account is changed you will have to reauthorize the source in Behold. You can do this by visiting the same auth link you used to connect it in the first place.Create a feed
related
Embedded widget
related
JSON Feeds
- Navigate to the feeds page and click on Add feed
- You will be prompted to choose between a user feed or hashtag feed. User feeds pull posts from a single account, hashtag feeds aggregate public hashtag content from across Instagram.
- Pick a source for your feed. If you are creating a hashtag feed, you must choose an advanced source.
- Choose between an embedded widget or JSON feed. If you are a developer and just want access to the raw feed, choose JSON. To get up and running fast with a drop-in JavaScript embed, choose Widget.
- Name your feed, or just click on Create feed to use the default name. You can change this later.
- You will be redirected to your feed admin page. Here you can see a preview of your feed, update settings, and access your embed code or JSON Feed URL.
Add your feed to a website
For details on coding your own feed UI with a JSON feed, please see our JSON feed docs. For instructions on adding the Behold embedded widget to various platforms, you can refer to our platform guides.
For now, here's how you can add an Instagram widget to a WordPress page using a custom HTML content block:
- Navigate to the feeds page and click anywhere on your widget to open the widget details popup.
- Click on Embed code in the sidebar
- Click on the copy button to add the code to your clipboard.
- Log in to the WordPress admin and navigate to a page or post edit screen.
- Hit return to add a new content block, click the +, and search for "Custom HTML."
- Paste your widget code into the Custom HTML block, and click update to save your changes. That's it! You can edit the number of posts, layout, appearance, mobile breakpoints, and more in the Behold admin.