Knowledge Base sync reports one of three states. Ready means it is working; the other two explain themselves once you know what they check.
| Status | What it means | What to do |
|---|---|---|
| Needs setup | Shopify's standard Knowledge Base record type is not enabled on your store yet. | Open Publish and retry. The app enables the record type itself on the next attempt; this usually resolves on its own within a sync or two. |
| Unavailable | The app could not confirm it has access to write the Knowledge Base, often a transient Shopify API issue. | Retry from Publish. If it stays unavailable after a day, write to us with your store address. |
What is never the cause
The app never fails to sync because of a Knowledge Base entry you or another app created: those are always left alone, never a source of conflict.
If it still is not working
Send us the details from Still stuck.
Related articles