Skip to content
Bricks Academy
Get Bricks

Instagram feed

The Instagram feed element loads media from the Instagram Graph API using an access token saved in Bricks → Settings → API keys (instagramAccessToken). Without a token, the element shows a placeholder asking you to connect the account.

Responses are cached in a transient to limit API calls; cache length is configurable.

Requirements

Section titled “Requirements”

Add a valid Instagram access token under Bricks → Settings → API keys. The element’s info message links there when the global token is missing.

Layout

Section titled “Layout”

  • Columns (number) — CSS grid columns for the list (ul). Placeholder: 3. Valid range on the front end: 1–6.

  • Posts (number) — How many posts to request (min 1, max 100). Placeholder: 9.

Image

Section titled “Image”

  • Object fit (select) — Applied to img.

  • Aspect ratio (text).

  • Height, Width (number with units).

  • Gap (number with units) — Gap on the ul grid.

  • Border (border) — Image border.

  • Link (checkbox) — Wrap each image in a link to the Instagram permalink.

Section titled “Carousel”

Optional styling for the carousel badge on CAROUSEL_ALBUM items:

  • Icon (icon), Icon color (color), Icon size (number with units), Icon position (dimensions).

Video

Section titled “Video”

Optional styling for the video play overlay on VIDEO items:

  • Icon (icon), Icon color (color), Icon size (number with units), Icon position (dimensions).

Caption

Section titled “Caption”
  • Enable (checkbox) — Show the post caption below the image.

When enabled: Background color, Border, Typography on .caption.

Follow

Section titled “Follow”

Optional “Follow us” row linking to instagram.com/{username}:

  • Text (text) — Default mentions @yourhandle; replace with your copy or dynamic data.

  • Position (select) — top or bottom.

  • Icon (icon) — Default Instagram logo.

  • Typography — .follow text.

Cache

Section titled “Cache”
  • Duration (select) — 30 minutes, 1 hour, 1 day, or 1 week (stored as seconds: 1800, 3600, 86400, 604800). Default placeholder: 1 hour.