Instagram

Introduction

Instagram is one of the main ways to collect user-generated content (UGC) in Socialphotos. There are two ways to bring it in:

  • Curate any public Instagram post by link. Paste the link to a post from a creator, a customer, or your own account. No Instagram connection or Business account is needed.
  • Connect your Instagram account to bring in your own posts, reels and stories, posts you're tagged in, mentions, and hashtags. This needs a Business or Creator account (see Requirements below). Reels and videos show in galleries on the Premium plan.

Either way, Instagram content becomes a source of UGC that you can:

  • Add to Page Galleries
  • Tag to products so it appears on product pages
  • Make shoppable across your store

Socialphotos does not automatically publish or display Instagram content. You always choose which photos or videos to use.

Instagram controls what third-party apps can access through a connected account. If a post isn't available that way, add it by link instead.

Before you begin

  • Make sure Socialphotos is installed on your Shopify store.
  • Open the Socialphotos app from Shopify Admin → Apps → Socialphotos.
  • For displaying UGC on your store, make sure your Page Gallery or Product Gallery is installed in your Shopify theme.
  • Product Gallery: UGC displayed directly on product pages.
  • Page Gallery: UGC displayed on store pages (for example, a Customer Photos page).

Helpful navigation: Settings → Instagram, Instagram → Tags, Instagram → Mentions, Instagram → Stories, Instagram → Hashtags, Instagram → Links.

Requirements

To connect your Instagram account, you need:

  1. Your Instagram account is set to a Business or Creator account.
  2. Your Instagram account is connected to a Facebook Page.

How to set your Instagram to a Business or Creator account

The steps here are copied from Instagram for convenience. Instagram changes frequently, so you may also want to search for the latest instructions.

  1. Go to your profile and tap Menu in the top right corner.
  2. Tap Settings and privacy.
    For some accounts, Switch to professional account appears directly under Settings.
  3. Tap Account.
  4. Tap Switch to professional account.
  5. Tap Continue.
  6. Select a Category for your business and tap Done.
  7. Tap OK to confirm.
  8. Tap Business.
  9. Tap Next.
  10. Add contact details and tap Next. To skip, tap Don’t use my contact info.
  11. Tap X in the top right to return to your profile.

How to connect a Facebook Page to your Instagram account

The steps here are copied from Instagram for convenience. Instagram changes frequently, so you may also want to search for the latest instructions.

  1. Go to your Instagram profile.
  2. Select Edit profile.
  3. Under Public business information, select Page.
  4. Tap Create Facebook Page or Connect an existing Page.
  5. Choose a Page to connect or create a new Facebook Page.
  6. Tap Done.

If the Page you want is not showing, it may be because you do not have access to that Facebook Page. Check the Page settings and permissions.

Permissions

Socialphotos requests the minimum Instagram permissions required to function. We do not post anything to your account.

  • instagram_basic
  • instagram_content_publish
  • instagram_manage_comments
  • pages_show_list
  • pages_read_engagement
  • Instagram Public Content Access

Learn more from Instagram's Permissions Reference.

Connect Your Instagram

To connect your Instagram:

  1. Go to Settings → Instagram
  2. Click Connect Your Instagram
  3. Complete the Facebook modal steps
  4. Select the Instagram account to connect
  5. Select the Facebook Page linked to that Instagram account
  6. Grant the required permissions
  7. Click Done
If the connection succeeds but you do not see content yet, check Limitations below. Mentions and hashtags are not retroactive.

Cannot Connect Issues

If you cannot connect your Instagram, the most common reasons are:

  1. Your Instagram account is not set to a Business or Creator account.
  2. Your Instagram account is not connected to a Facebook Page.

Check your Instagram account type

  1. Open the Instagram app on your phone.
  2. On your profile screen, confirm it shows a professional account.
  3. Tap Edit Profile.
faq-ig-pro-account_2x

Check the Facebook Page linked to your Instagram

  1. Open the Instagram app on your phone.
  2. Go to your profile screen.
  3. Tap Edit Profile.
  4. Under Public business information, find Page.
  5. Confirm a Facebook Page is linked.
faq-ig-page-connect_2x

Limitations

Instagram controls what content third-party apps can access. Socialphotos can only retrieve content that Instagram allows.
  1. Mentions and hashtags are not retroactive.
    Instagram does not allow third-party apps to fetch past mentions or past hashtag content. Only mentions and hashtags created after your Instagram account is connected can be retrieved.
  2. Hashtag tracking limit.
    Instagram limits tracking to a maximum of 30 hashtags.
  3. Access tokens expire.
    Instagram connections end every 3 months, or sooner, and need reconnecting. Socialphotos emails you before that. See Why Instagram needs reconnecting.
  4. Some reels may be unavailable.
    Instagram may block access to reels that contain copyrighted audio.
  5. Content visibility.
    Private posts, removed posts, or restricted content may be unavailable to third-party apps.

General guidance:

  1. Encourage customers to tag your account. Tagged content is the most reliable source.
  2. Use a small, consistent set of hashtags to stay within Instagram’s limits.

Instagram Stories: keep your stories after 24 hours

Stories disappear from Instagram after 24 hours. Once your Instagram is connected, Socialphotos checks for new stories every hour and saves them, so they stay available after they expire on Instagram. Add them to galleries and tag products like any other photo.

Find them in Instagram → Stories. Click Refresh to check right away.

What's included

  • Photo and video stories posted by your connected account. Photo stories show on every plan; video stories show in galleries on Premium.
  • Stories from the time you connect, plus any still live on Instagram. Older stories can't be retrieved.

What Instagram doesn't share

  • Stories from customers who mention you, and stories you reshare from other accounts. To feature those, ask the customer for the photo and add it with Bulk Uploads, or add their post by link.
  • Live videos.
  • Some video stories with licensed music.

Paste the link to any public Instagram post and Socialphotos imports its photos or video, ready to add to your galleries or tag with products. You don't need to connect an Instagram account, and the post doesn't have to be yours. Socialphotos stores the media, so it keeps showing in your galleries even if the post later changes.

  • A creator or influencer posted about your product
  • You found a customer's post featuring your product
  • You want an older post, or one that isn't available through a connected account
  • You haven't connected Instagram, or your account isn't a Business or Creator account

Make sure you have the creator's permission to feature their content on your store.

  1. In the Socialphotos app, go to Instagram → Links.
  2. Click New Instagram Link.
  3. Paste the Instagram post URL.
  4. Click Create.
  5. Socialphotos imports the post in the background. Progress shows on Instagram → Links, and you can keep working meanwhile.
Imports can fail if the post is private, deleted, or restricted by Instagram. If that happens, ask the creator for the original file and add it with Bulk Uploads.

Once the content is imported, it will appear under Instagram → Links. From there, you can curate it into your galleries.

Page Gallery

  • On the imported UGC, click Add To Gallery.
  • Select the Page Gallery you want.

Product Gallery

  • On the imported UGC, click Tag Product.
  • Search and select the product.
  • Make sure your Page Gallery or Product Gallery is installed in your Shopify theme.
  • If you need help installing a gallery, see the How To Guide.
  • It may fail for private posts, removed posts, or restricted content.
  • If Instagram changes how their pages work, this feature may be affected.

Your Instagram Feed: hide posts and tag products

The Instagram Feed shows your Instagram posts on your store automatically, newest first. Go to Display → Instagram Feed to see the posts shoppers see and choose what stays.

  • Hide a post: click Hide on it. It leaves the feed on your store right away and stays hidden when we fetch your posts again. Nothing is deleted.
  • Bring it back: open the Hidden tab and click Show.
  • Make a post shoppable: click Tag Product on it. Shoppers see the product when they open the post in the feed (Advanced plan and up, with Show shoppable products on in the feed's Gallery settings). Tagging also adds the photo to that product's gallery on its product page.
  • Layout and look: click Gallery settings at the top of the page.

Carousel posts show their first photo. Videos show in the feed on Premium. With several Instagram accounts connected, pick one at the top to see its feed.

FAQ

Q.

I received an email that says "Instagram token expires in X"

Facebook asks you to confirm every 3 months. Go to Settings → Instagram, click "Connect Your Instagram", then click "Continue as …". See Why Instagram needs reconnecting.

Q.

I already connected Instagram, but I am missing mentions or hashtags from older posts

This is an Instagram API limitation. Instagram does not allow third party apps to fetch old mentions or old hashtag content. Socialphotos can only fetch mentions or hashtag content after you connect your Instagram, not before.

Q.

Why is my Instagram Feed missing some posts?

If the missing post is a reel, it may contain copyrighted audio. Instagram may block third party apps from fetching that media.

faq-reels-copyright-audio_2x
Q.

How often does my Instagram Feed gallery update?

Automatically. We fetch your newest posts every hour and your storefront gallery updates when we find one, so there's nothing to set up. To fetch them right away, click Refresh on the Instagram Posts page.

Q.

I deleted a post on Instagram but it still appears on Socialphotos

We check your 100 most recent posts every day, so a recently deleted post is removed within 24 hours. Older posts are checked weekly, so they can take up to a week. To remove them sooner, use Full Resync on the Instagram Posts page.

Q.

What does Full Resync do?

It fetches all your posts from Instagram, adds any we're missing, and removes any that are no longer on Instagram. Your gallery keeps showing your current posts until it finishes, and we email you when it's done. Posts you deleted in Socialphotos come back if they're still on Instagram, and your Curated content isn't affected. Instagram only shares your 10,000 most recent posts, so anything older is left as it is.

Q.

I started tracking a hashtag, but I am not seeing any customer photos or videos

This is an Instagram API limitation. Instagram does not allow third party apps to fetch old hashtag content. We can only fetch hashtag content after you connect your Instagram, not before.

Q.

I cannot connect Instagram

See Cannot Connect Issues .

Q.

I see older customer photos and videos that I want to use. How do I add those?

If your customers tag you on their posts, you will see it on your Instagram → Tags page (how to show tagged posts on your store). If they did not tag you, you can mention yourself in their post's comments and it may appear under Instagram → Mentions. If you have the link to a post, you can use Instagram → Links.

Multiple Facebook Pages and Instagram accounts

Each Instagram professional account is linked to one Facebook Page. If your Facebook login manages several Pages, Socialphotos can connect the Instagram account of each one, up to 10 per store.

  • The first time you connect, Socialphotos connects the Instagram account of every Page you choose when Facebook asks which Pages to share.
  • Settings → Instagram lists every Page Facebook shared and whether its Instagram account is Connected, Not connected or Removed. Pick a row, then click Connect or Remove above the table.
  • Removing an account removes its posts, tags, mentions and stories from Socialphotos. Photos already in your galleries stay.
  • To add a Page you didn't share, click “Connect Your Instagram” and choose it when Facebook asks which Pages to share.
  • Instagram Posts, Tags, Mentions and Stories have an account menu, so you can look at one account at a time.
  • On your store, each Instagram feed shows one account. Enter its username in the Instagram Post Gallery block's Instagram username setting, or leave it blank to show your first account. Add one block per account to show several.
  • To see which Page an Instagram account is linked to, open Instagram and tap Edit Profile.
  • Instagram Edit Profile showing the linked Facebook Page
If you make changes to your Instagram or Facebook Page, re-connect via Settings → Instagram → "Connect Your Instagram".

Why Instagram needs reconnecting

Socialphotos reads your Instagram through your Facebook login. From time to time Instagram and Facebook end that access. New posts, tags and mentions then stop coming in until you reconnect. Everything already in Socialphotos and your galleries stays as it is.

Every 3 months

Facebook asks you to confirm every 3 months that Socialphotos can still read your Instagram. In the last week before it ends, we email you each day until you reconnect.

Other reasons it can end sooner

  • You changed your Facebook or Instagram password.
  • Instagram or Facebook noticed unusual activity on your account and logged you out to keep it safe.
  • You haven't used Facebook in a while and it logged you out.
  • You changed your Facebook Page, linked your Instagram to a different Page, or switched Instagram back to a personal account.
  • You removed Socialphotos from Facebook's Business Integrations, or unchecked a Page or permission while connecting.

When this happens, Socialphotos shows a red notice at the top of every page and emails you, unless you turned off Instagram problem emails in Settings → Email Notifications.

How to reconnect

It takes about 10 seconds:

  1. Go to Settings → Instagram.
  2. Click "Connect Your Instagram".
  3. In the Facebook window, click "Continue as …" with your name.
  4. The window closes and the connection is back.

Because you connected Socialphotos before, Facebook takes "Continue as …" as your OK to keep the access going. If reconnecting doesn't fix it, see Error messages below or email support@socialphotosapp.com.

Error Messages

If there is an issue with your Instagram connection, Socialphotos will email you. Most of the time, re-connecting fixes the issue.

Common Instagram errors:

Code Subcode Message Interpretation
100 (#100) The parameter user_id is required. Your Facebook Page is not connected to your Instagram account
100 33 Unsupported get request. Object with ID 'xxxx' does not exist, cannot be loaded due to missing permissions, or does not support this operation. You did not grant Socialphotos the right permissions
193 460 Error validating access token: The session has been invalidated because the user changed their password or Facebook has changed the session for security reasons. You changed your Instagram or Facebook password
193 463 Error validating access token: Session has expired on xxxx, xx-xx-xx xx:xx:xx. The current time is xxxx, xx-xx-xx xx:xx:xx. Your Instagram token has expired
200 (#200) Requires instagram_basic permission to manage the object You did not grant Socialphotos the right permissions

The fix is usually to re-connect: Settings → Instagram → "Connect Your Instagram".

Common Issues

Instagram Disconnected

Instagram can disconnect your account for many reasons, including password changes or suspicious activity.

The fix is usually to re-connect: Settings → Instagram and click "Connect Your Instagram".

Cannot Track Certain Hashtags

Some hashtags may not be trackable due to Instagram restrictions, including adult content rules or the hashtag not existing yet.

On this page