Note: While our most popular guides have been translated into Spanish, some guides are only available in English.

Instagram Blocks

Use Instagram Blocks to display Instagram posts on your site. This is a great way to showcase your Instagram images or videos without manually adding them to Gallery Blocks or Gallery Pages. As you add content to a connected Instagram account, Instagram Blocks sync to show your latest posts on your site.

Watch a video

Add the Instagram Block

To add an Instagram Block:

  1. Edit a page or post, click an insert point, and select Instagram from the menuFor help, visit Adding content with blocks.
  2. In the Account tab of the block editor, click the Connected Account drop-down menu to select a previously connected Instagram account, or select Add an account and follow the authorization steps to connect a new one.
  3. Set the number of items to display, up to 20.
  4. In the Design tab, choose a design and customize display settings.
  5. Click Apply to save your changes.

Tips and limitations

Keep in mind:

  • Instagram doesn't support filtering posts in Instagram Blocks by a search term or hashtag.
  • If you connect a private Instagram account to an Instagram Block, posts will appear in the block but lead to a dead link when clicked. To avoid this, set your Instagram account to public.
  • Instagram posts with multiple images or videos display the first item as a static image in Instagram Blocks. In the Design tab of the block editor, check Open links in new window to link visitors to the full post.
  • Instagram blocks don't support IGTV posts.

Choose a design

In the Design tab, choose how posts will display in the block. There are four designs to choose from, and you can customize them with different options like aspect ratio, padding, and how posts appear when you click them. The four designs are:

  • Slideshow - Posts display one at a time
  • Carousel - Posts display in full with portions of the previous and next posts on either side, depending on the settings
  • Grid - Posts display as a grid of thumbnail images
  • Stacked - Posts display at full width, one on top of the other

When you're done customizing the design, click Save. For more information, see Options for each Instagram Block design.

Tip: Some design options display differently on mobile devices. You can preview your settings with Device View

Options for each Instagram Block design

Design option Block behavior
Automatically Transition Between Slides Automatically switches to the next post after a set period of time. When checked, a slider appears for setting the transition time between one and 10 seconds.
Show Next and Previous Controls Adds arrows for navigating to the next and previous posts. The controls appear in overlays to the left and right of the main post.
Automatically Crop Images Crops or resizes the posts for the best design.
Show Thumbnails Adds a strip with thumbnails of all images and videos in the block below the main post. When checked, sliders to set the height of the thumbnail strip and the distance between the thumbnail strip and the main post.
 
Show Caption

Displays post descriptions. When checked, more options appear to set the position of the descriptions and to only display them on hover. Learn how your template styles these captions.

The descriptions won't display on mobile.

Open Links in New Window Opens Instagram in new tab when visitors click posts.
Design option Block behavior
Automatically Transition Between Slides Automatically switches to the next post after a set period of time. When checked, a slider appears for setting the transition time between one and 10 seconds.
Show Next and Previous Controls Adds arrows for navigating to the next and previous posts. The controls appear in overlays to the left and right of the main post.
Active Alignment Focuses the block on an active post. This post appears in full.
Open Links in New Window Opens Instagram in new tab when visitors click posts.
Design option Block behavior
Aspect Ratio Controls the dimensions at which your posts display.
Crop Images Removes padding from posts' containers and displays them at the size selected in the Aspect Ratio drop-down menu.
Thumbnails Per Row Customizes the number of thumbnails in a row in the grid.
Padding Adjusts the padding outside of the posts' containers.
Lightbox

Opens a post with a black background when visitors click the post.

The post's caption will display on hover in the lightbox. On mobile, tap the circle in the bottom-right corner of the lightbox to display the post's caption. Learn how your template styles these captions.

Open Links in New Window Opens Instagram in new tab when visitors click posts. This option won't work if the lightbox is enabled.
Design option Block behavior
Show Caption

Displays post descriptions below each post. Learn how your template styles these captions.

Open Links in New Window Opens Instagram in new tab when visitors click posts.

Troubleshooting

Follow the steps below to troubleshoot issues with Instagram Blocks. Common issues include:

  • The block doesn’t match the Instagram feed.
  • The block shows duplicate or incorrect posts.
  • The block shows archived posts.
  • The block shows an error message: “There are no items to display from the selected collection.”
  • The block doesn't appear at all.
Tip: Instagram Blocks update about every 30 minutes, so new posts may not appear immediately.

Step 1 - Check the connection

You can resolve most issues by ensuring the Instagram connection is set up correctly:

  1. In the Home Menu, click Settings, then click Connected Accounts.
  2. Click your Instagram account.
  3. Ensure Download Data is checked.
  4. Click Reset Data.
  5. Click Save.
  6. Refresh the webpage.

Step 2 - Reconnect the account

If you’re still seeing issues, or if you see an “Unauthorized: Remove or reauthenticate this account for continued usage” error message, disconnect and reconnect your Instagram account:

  1. In the Connected Accounts panel, click your Instagram account.
  2. Click Disconnect.
  3. Click Confirm.
  4. In a separate tab, log out of all Instagram accounts on your device.
  5. Return to your Squarespace site; in the Connected Accounts panel, click Connect.
  6. Select Instagram from the Social Accounts menu, then log in using your Instagram username and password.
  7. Click Save.
  8. Refresh the page.

Step 3 - Replace the block

If the issue still isn't resolved, remove the block and add a new one:

  1. In the Home Menu, click Pages, then click the page with the Instagram Block.
  2. Hover over the page and click Edit.
  3. Hover over the Instagram Block and click the trash can icon.
  4. Click an insert point and select Instagram.
  5. Select your Instagram account and click Save.
  6. Refresh the page.

Step 4 - Disable ad blockers and browser extensions

Instagram Blocks might not display if you're using ad blockers in your browser. We recommend removing any ad blockers to see if that helps. If you still can't see these blocks, try disabling all browser extensions. If you continue to have trouble, contact us.

Was this article helpful?
144 out of 426 found this helpful