Troubleshooting

Check the following in order:

1. Open your browser’s developer console (F12 → Console) and look for any errors starting with [FeedEmbed].
2. Confirm the script tag is present on the page and the src is correct: https://widget.feedembed.io/script.js.
3. Confirm the container has data-feedembed-feed with your exact embed key (no extra spaces).
4. In the dashboard, check that your feed has posts — the feed detail page shows the last poll time and post count.
5. If you have allowed domains configured, make sure the domain you’re testing on is in the list. Check the browser Network tab for a 403 response.

This means the widget loaded successfully but your feed has no cached posts. This happens when:

• The feed was just created and the first poll hasn’t run yet — wait a minute and refresh.
• Your Instagram account has no public posts.
• Your Instagram token expired or was revoked. Go to Sources in the dashboard — if the account shows an error, disconnect and reconnect it.

Your domain is not in the feed’s allowed domains list. Either:

• Add the domain to the allowlist in the feed’s settings (see Allowed domains).
• If you’re testing locally, add localhost temporarily.

The refresh interval depends on your plan (daily on Free, hourly on Solo, etc.). If you’ve recently posted and the post isn’t appearing after your plan’s interval, check:

• The feed’s Last polled time in the dashboard — it should match your expected interval.
• Your Instagram account is still connected and the token hasn’t expired (check Sources).
• The post is public — private posts are not accessible via the API.

Check for CSS conflicts:

• A global * { box-sizing: content-box } rule on your site can break the grid layout. The widget relies on border-box.
• If the images aren’t loading, check the Network tab — they’re served from Instagram’s CDN and may be blocked by a Content Security Policy (CSP) on your site. Add *.cdninstagram.com to your img-src CSP directive.

Almost always a domain allowlist issue. Make sure your production domain is in the list. Also check that you’re using the production embed key, not a test key.

Instagram access tokens expire after 60 days unless refreshed. FeedEmbed refreshes them automatically before expiry. If a token shows as invalid, it likely means:

• You changed your Instagram password (this revokes all tokens).
• You removed FeedEmbed from your Instagram connected apps.
• Meta revoked the token due to inactivity or a policy change.

To fix it: go to Sources → disconnect the account → reconnect it.