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.
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.
Gallery terms
- 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:
- Your Instagram account is set to a Business or Creator account.
- 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.
- Go to your profile and tap Menu in the top right corner.
-
Tap Settings and privacy.
For some accounts, Switch to professional account appears directly under Settings. - Tap Account.
- Tap Switch to professional account.
- Tap Continue.
- Select a Category for your business and tap Done.
- Tap OK to confirm.
- Tap Business.
- Tap Next.
- Add contact details and tap Next. To skip, tap Don’t use my contact info.
- 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.
- Go to your Instagram profile.
- Select Edit profile.
- Under Public business information, select Page.
- Tap Create Facebook Page or Connect an existing Page.
- Choose a Page to connect or create a new Facebook Page.
- 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:
- Go to Settings → Instagram
- Click Connect Your Instagram
- Complete the Facebook modal steps
- Select the Instagram account to connect
- Select the Facebook Page linked to that Instagram account
- Grant the required permissions
- Click Done
Cannot Connect Issues
If you cannot connect your Instagram, the most common reasons are:
- Your Instagram account is not set to a Business or Creator account.
- Your Instagram account is not connected to a Facebook Page.
Check your Instagram account type
- Open the Instagram app on your phone.
- On your profile screen, confirm it shows a professional account.
- Tap Edit Profile.
Check the Facebook Page linked to your Instagram
- Open the Instagram app on your phone.
- Go to your profile screen.
- Tap Edit Profile.
- Under Public business information, find Page.
- Confirm a Facebook Page is linked.
Limitations
-
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. -
Hashtag tracking limit.
Instagram limits tracking to a maximum of 30 hashtags. -
Access tokens expire.
Instagram connections end every 3 months, or sooner, and need reconnecting. Socialphotos emails you before that. See Why Instagram needs reconnecting. -
Some reels may be unavailable.
Instagram may block access to reels that contain copyrighted audio. -
Content visibility.
Private posts, removed posts, or restricted content may be unavailable to third-party apps.
General guidance:
- Encourage customers to tag your account. Tagged content is the most reliable source.
- 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.
Instagram Links: curate any public post
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.
When to use this
- 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.
How to add an Instagram link
- In the Socialphotos app, go to Instagram → Links.
- Click New Instagram Link.
- Paste the Instagram post URL.
- Click Create.
- Socialphotos imports the post in the background. Progress shows on Instagram → Links, and you can keep working meanwhile.
What happens next
Once the content is imported, it will appear under Instagram → Links. From there, you can curate it into your galleries.
Add imported UGC to 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.
Important
- 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.
Limitations
- 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
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.
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.
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.
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.
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.
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.
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.
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.
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:
- Go to Settings → Instagram.
- Click "Connect Your Instagram".
- In the Facebook window, click "Continue as …" with your name.
- 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.