Troubleshooting the Shopify app

This means the app's access to your store is missing a permission it needs, normally because the store was installed before that feature existed. Shopify only grants permissions at install time, so the fix is to reinstall Alt Text Studio.

Open the Connection page. If it does not show a linked account, paste a fresh key from API Keys. If it is connected but generations still fail, check the credit balance on Home — generation stops when an account runs out.

Check three things in Settings: Auto-generate for New Images has to be on; Overwrite Existing Alt Text has to be on if the image already had alt text; and the account needs credits. The app also gives up on an individual image after three failed attempts, so an image that cannot be read — a corrupt file, for instance — is not retried forever. Generating it by hand from the product page shows the actual error.

Large catalogs take a while, and the app says so with a *"Scan is taking longer than usual"* notice rather than failing. You can leave the page — the results are saved when it finishes. If it seems genuinely stuck, click Cancel scan and then Scan catalog again.

Shopify only serves translations for languages your store actually publishes. If you generated, say, Portuguese but your store does not publish it, the text is stored on your account but never reaches shoppers. Publish that language in your Shopify Markets settings, then regenerate or use the language pills on the product page. See Multi-language alt text.

Send us a message with your store's name and what you were doing, or file a bug report and pick Shopify App as the subject.