Troubleshooting
The fastest fixes for the problems we see most — signing in, connecting a store and syncing.
Sign-in problems
| Symptom | Fix |
|---|---|
| The sign-in tab opened but the plugin keeps waiting | Finish on the tab: sign in, then press Continue as …. The plugin picks the session up within a few seconds. If it still waits, press Open the sign-in page again |
| The sign-in did not finish | The link expired (10 minutes) or was opened from a different network than Framer. Press Sign in again and complete it on the same device |
| No tab opened | Your browser blocked the pop-up. Allow pop-ups for framer.com and press Sign in again |
| Plugin asks for a subscription you already paid | Press I have paid, or sign out and back in. Still locked? Check the status at app.framerlink.com/billing |
Connection problems
| Symptom | Fix |
|---|---|
| That doesn't look like a Shopify domain | Use the your-store.myshopify.com address, not a custom domain |
| Shopify rejected the token | Copy the public access token again from Headless → your storefront → Storefront API. The private token does not work here |
| Missing permission | In the Headless channel open Storefront API → Manage and enable the permission named in the message |
| This store is already connected | The same account already connected this store in another project. Remove it at app.framerlink.com/stores, or open that project |
| Could not save the connection | The Framer project is read-only for you (a template, a view-only share or a locked project). Open a project you can edit |
| Plugin connects but forgets everything | Open the plugin from the Framer canvas; some Framer surfaces block saving plugin data. Connect again |
More detail in Connecting your store.
Nothing imports, or products are missing
The Storefront API only returns products and collections published to the Headless channel. In Shopify, select the products, choose Make available and pick Headless; do the same for collections. Run Import Products again.
Sync problems
| Symptom | Fix |
|---|---|
| Import stops with a name conflict banner | A CMS collection with the same name exists and isn't managed by Framerlink — delete or rename it in the Framer CMS panel, then re-run Import Products |
| Items still landing after the import "finishes" | Large catalogs keep writing in the background — the CMS fills in shortly; refresh the CMS panel |
| A field you removed keeps its old values | Field changes apply from the next sync onward; run one import after changing the selection |
| Auto-Sync is on but nothing updates | Check the three prerequisites in the Auto-Sync settings: private token, project URL and Server API key — see Auto-Sync |
| Auto-Sync shows Needs attention | Three runs in a row failed, usually a revoked Server API key or a changed project URL. Fix the credential, then press Try again |
| Sync seems stuck or erroring | Open the Sync log in the plugin's CMS view — every run is listed with its result |
Getting help
Still stuck? Use Contact support inside the plugin or write to hi@framerlink.com — include your store domain and what the sync log shows, and we'll dig in.