Troubleshooting

If something is not working as expected

Written By Social Hampster

Last updated 2 days ago

If something is not working as expected, this article covers the most common issues and how to fix them.

Component not appearing after clicking in the plugin

Make sure the Framer canvas is focused, click somewhere on the canvas area first. Then click the component in the plugin panel again. If it still does not appear, try closing and reopening the plugin panel.

Feed shows in Framer preview but not on the published site

This is the most common issue. It almost always means your domain has not been whitelisted.

Fix:

  1. Go to app.socialhampster.com/settings

  2. Find the Domain Whitelist section

  3. Add your published domain in the format yoursite.com — no https://, no trailing slash

  4. Save, then republish your Framer project

If you have a custom domain and also want the feed to work on your Framer preview URL (yourproject.framer.website), add that separately as a second entry.

Instagram won't connect

Instagram's API requires a Creator or Business (Professional) account. Personal accounts are blocked by Meta and cannot be used with any third-party app including Social Hampster.

Fix:

  1. Open the Instagram app on your phone

  2. Go to Settings and privacy, then Account type and tools

  3. Tap Switch to Professional account and choose Creator or Business

  4. Return to the Social Hampster dashboard and try connecting again

Component shows a loading spinner and never loads

This can have two causes:

  • Domain not whitelisted: Go to app.socialhampster.com/settings and add your domain (see above)

  • OAuth token expired: Your connection to the social platform has expired or been revoked. Go to the dashboard, find the affected feed, delete it, and reconnect the account using the + Create New Feed button

Posts are not updating or the feed is showing old posts

Fix:

  1. Go to app.socialhampster.com

  2. Find the feed in the Your Feeds list

  3. Click the Sync button on the feed card

This triggers an immediate fetch of your latest posts from the social platform. Feeds also sync automatically on a regular schedule, but the Sync button lets you update right away.

Component disappeared from my Framer project

If a component has been accidentally deleted from your Framer canvas, your feed data is not lost. The feed still exists in the dashboard.

Fix:

  1. Go to app.socialhampster.com

  2. Click Details on the feed you want to restore

  3. Click Copy next to the layout you want

  4. Paste into Framer with Cmd+V or Ctrl+V

Feed shows 0 posts

Possible causes:

  • The connected social account has no public posts. Check the account directly on the platform to confirm there are published posts.

  • The OAuth token has expired. Delete the feed in the dashboard and reconnect the account.

  • A Media Type filter prop is set too narrowly (for example, Reels only on an account with no Reels). Check the Media Type prop on the component in Framer and set it to All.

  • The account was switched to private after connecting. Social Hampster can only fetch public content.

Billing is not going through

Billing is handled by Polar. If a payment fails:

  • Check that your card details are correct in the Polar dashboard

  • Try a different payment method

  • If the issue persists, contact Social Hampster support so the team can assist or check for billing errors on the Polar side

Reels are not showing

Check the following:

  • Reels require a Personal or Business plan. The free plan does not support Reels.

  • The Media Type prop on the Instagram component must be set to All or Reels only (not Photos only)

  • Your Instagram account must be a Creator or Business type

  • Click Sync on the feed card in the dashboard to refresh

Video is not autoplaying

Browsers require videos to be muted before they can autoplay. This is a browser-level policy and applies to all websites, not just Social Hampster.

Fix: In the Framer props panel, make sure both Autoplay and Muted are turned on. If Muted is off, the browser will block autoplay silently and the video will not start.

Still stuck?

If none of the above solves your issue, reach out to the Social Hampster support team. Business plan users receive priority support. When contacting support, it helps to include:

  • Which platform is affected (Instagram, Facebook, YouTube, Threads, or Dribbble)

  • Which component layout you are using (Grid, Masonry, Slider, or Profile)

  • A description of what you see (loading spinner, blank, 0 posts, etc.)

  • Whether the issue happens in Framer preview, on the published site, or both