> For the complete documentation index, see [llms.txt](https://docs.overflowcms.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.overflowcms.com/troubleshooting.md).

# Troubleshooting

## Troubleshooting

### Troubleshooting

#### Nothing renders on my Webflow page

* Open the browser console. The embed script logs `[OverflowCMS] no data-oc-token found on any script tag.` if the `<script>` tag is missing its `data-oc-token` attribute, or is loaded after the page tries to render (it self-inits on `DOMContentLoaded`, so load order isn't usually the issue — a missing/wrong token is).
* Check that the container has `data-oc-list="<collection-slug>"` and the slug matches exactly what's shown in the collection's **Integrate** tab.
* A `data-oc-list` container needs a `data-oc-item` element somewhere inside it to use as the template — it can be a direct child or nested in its own wrapper (see Embed Script Basics → “Giving the cards their own layout”). If it's missing entirely, the script returns early and renders nothing.

#### An item exists but doesn't show up

* Only **published** items are served by the public API — drafts never appear, by design. Check the item's status in the collection's Content tab.
* If you just published, allow a few seconds: publish bumps a per-site cache-bust key, and the next request re-fetches from the database. If it's been longer than that and it's still stale, check whether you're looking at a cached response from an intermediary (e.g. a browser extension, or a CDN in front of your Webflow site) rather than OverflowCMS's own cache.

#### An image field doesn't render

* The field has to be bound to an actual `<img>` element: `<img data-oc-field="cover">`. Binding a non-image element (a `<div>`, say) to an image-type field sets nothing — the script only writes `src`/`srcset`/`alt` onto `HTMLImageElement`s.
* If the image element exists but stays broken, check that the item actually has a value for that field — an empty/never-set image field has nothing to bind.

#### "Load more" button doesn't do anything

* It only appears (and only re-shows) when there are more pages: the script hides it once `page >= totalPages`. If you have fewer items than `data-oc-limit`, there's nothing more to load and the button stays hidden — that's expected, not a bug.

#### I can't create a new site

* A workspace needs an active paid plan to create sites — see Plans & Billing. The create-site form only appears once a plan is active; otherwise you'll see a "Choose a plan to create sites" prompt instead of a 402 error.

#### I invited a teammate but they didn't get an email

* The invite link is also copied to your clipboard the moment you create it (toast: "Invite emailed — link also copied to clipboard") — forward that link directly as a fallback while they check spam.
* Invites expire; if enough time has passed, revoke and re-create the invite from the Members page.

#### Checkout succeeded but my plan still shows the old tier

* The billing page reconciles automatically when you land back on `?checkout=success` after Stripe Checkout — give it a moment on that redirect. If you navigated away before the redirect completed, open **Billing** again; it re-syncs the real subscription state from Stripe on load.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.overflowcms.com/troubleshooting.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.