DocumentationGetting Started

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

  1. First make sure you are logged-in to the Instagram account you want to access. Once this is done, click on the green “+ Add Account” button in the Behold dashboard.
  2. You will see an option to choose either the “Basic API” or “Graph API”. For now, select the Basic API.
  3. After being redirected to Instagram, click “allow”.
  4. You should then see a loading screen, followed by your dashboard with a new account added.

Create a feed

  1. Click on "+ Add Feed".
  2. Next you will be prompted to choose between an API feed or embeddable widget. If you are a developer and want access to the raw JSON so you can build your own UI choose "API." To get up and running fast with our flexible drop-in embeddable feed, choose "widget."
  3. Name your feed, or click on "Create Feed" to use the default name.
  4. Your new feed will appear on your dashboard. It will display the number of views for the current month, feed type, account type and account name. Click on the three dots next to the feed title to access an actions menu.
  5. Click anywhere on your new feed. This will show the feed details popup, where you can see a preview of your feed, update settings, and access your embed code or JSON API URL.

Add your feed to a website

For details on coding your own feed UI with the JSON API, please see our API docs. For instructions on adding the Behold embeddable widget to various platforms, you can refer to our widget docs.

For now, here's how you can add an Instagram widget to a WordPress page using a custom HTML content block:

  1. Navigate to the Behold dashboard and click on your widget to open the widget details popup. You will see your embed code on the top left.

  2. Click on the "copy" button to add the code to your clipboard.

  3. Log in to the WordPress admin and navigate to a page or post edit screen.

  4. Hit return to add a new content block, click the "+", and search for "Custom HTML."

  5. 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, appearance, hover styles, mobile breakpoints, and more in the Behold admin.

Ready to Get Started?

Create a Free Account