Feature the most recent images from your Instagram feed on your site.
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:
- Edit a page or post, click Add Block or an insert point, and choose Instagram from the menu. For help, visit Adding content with blocks.
- Open the block editor by clicking the pencil icon on the block.
- In the Account tab, 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.
- Set the number of items to display, up to 20.
- In the Design tab, choose a design and customize display settings.
- Click Save to save your changes and keep editing, or click Exit and then Save to close the editor.
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, Stories, shared posts, or Reels.
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 parts 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. To learn more, visit 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. 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. 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 chosen 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. Keep in mind, while we can offer troubleshooting advice, any issues caused by policy changes or product updates on Instagram's end fall outside our scope of support. 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:
- Open the Connected Accounts panel.
- Click your Instagram account.
- Ensure Download Data is checked.
- Click Reset Data.
- Click Save.
- Refresh the webpage.
Step 2 - Reconnect the account
If you’re still having issues, or if an “Unauthorized: Remove or reauthenticate this account for continued usage” error message displays, disconnect and reconnect your Instagram account:
- In the Connected Accounts panel, click your Instagram account.
- Click Disconnect.
- Click Confirm.
- In a separate tab, log out of all Instagram accounts on your device.
- Return to your Squarespace site. In the connected accounts panel, click Connect.
- Choose Instagram from the Social Accounts menu, then log in using your Instagram username and password.
- Click Save.
- Return to the Instagram block. In the account tab of the block editor, click the Connected Account drop-down menu to re-select your Instagram account
- Click Save to save your changes and keep editing, or click Exit and then Save to close the editor.
Step 3 - Replace the block
If the issue still isn't resolved, remove the block and add a new one:
- Open the Pages panel and click the page with the Instagram block.
- Hover over the page and click Edit.
- Hover over the Instagram block and click the trash can icon.
- Click an insert point and choose Instagram.
- Select your Instagram account and click Save.
- 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 start. If you're still having block display issues, try disabling all browser extensions. If you continue to have trouble, contact us.