Troubleshooting
The common problems and what to do about each one: signing in, changes that don't show, missing buttons, photos, forms, domains, AI and API keys.
On this page
The common problems, and what to do about each one. If yours isn't here, see Still stuck? at the end.
Signing in
"No access yet? Ask the site's owner to invite you." This line is always under the sign-in form. If you can't get in, your email has no access to this site yet. Ask its owner or an admin to invite the exact address you sign in with.
"You are signed in as …, but you do not have access to …" You signed in with an account this site doesn't know. Press Use another account and sign in with the address you were invited with.
The invitation email didn't arrive. Check your spam folder. Then ask the person who invited you to press Resend next to your address under Invited, in Settings → Users. If the email can't be sent, that row offers Copy link, so they can send you the link themselves.
The Console takes me to my site's admin.
That is how it works today: with a site of your own, signing in at console.clearcms.app opens your site's admin. To make another site, go to console.clearcms.app/start. See Organizations and the Console.
My change isn't on the live site
- It's still a draft. Press Publish. Contributors can't publish: an editor, an admin or the owner publishes for them.
- It's a scheduled record. Clear looks for records that are due every 15 minutes, so a record can go live up to 15 minutes after its time. Pages can't be scheduled: publish them yourself.
- The page was published again after your draft began. The editor says so, and asks before your draft replaces the newer page. See Saving and publishing.
- Your browser shows an old copy. Reload the page.
A button I need is missing
Most buttons depend on your role on the site. See Users and roles.
| You can't… | Because |
|---|---|
| See Settings | It needs the Designer role or higher. A designer sees only Design; an admin sees everything but Domains |
| See Domains | Only the site's owner sees it |
| Publish | Contributors and viewers can't publish |
| Use Builder (blocks and layout) | It needs the Editor role or higher, unless the owner kept layout and style to designers (Settings → Users → Who can change layout and style) |
| Use Designer | It needs the Designer, Admin or Owner role. On live sites, while Designer is being finished, only owners and admins get it |
| See Forms and Inbox | Forms are switched off in Settings → Add-ons |
| Add pages or blocks on some sites | The site's own code lays out its pages; the admin says so, and you edit their content under Collections |
The editor says "Still waiting for the site"
The editor shows your real site beside it, and it can take a moment the first time. It keeps trying by itself; press Try now to try at once. If it keeps waiting, reload the page.
The header or a block is locked
Click its padlock. If your role may open it, a menu offers to Unlock it; choose that. The header and footer are on every page, so only a designer, an admin or the owner can unlock them. A locked block, or its words, needs an editor or higher. Anyone else sees who can.
Photos and files
- "Over 20 MB": make the file smaller first. Photos and PDFs can be up to 20 MB, videos 50 MB, and text files 5 MB.
- "Not a photo, video, PDF or text file": Media takes JPEG, PNG, WebP, GIF, AVIF, SVG, PDF, MP4, WebM, MOV, and plain text files (Markdown, text, JSON, CSV or CSS).
- "This site's storage is full": delete files you don't use (in Media, the filter Needs a look → Not used finds them), or ask for more space.
- A photo is cut badly on phones: choose what stays in view. See Editing a photo.
- I deleted a photo by mistake: open Deleted files in Media, then Put back.
Forms
- The Inbox says "Email is not set up here: answers are saved, but nobody is emailed." Every answer is in the Inbox, but no email goes out about it. Ask your web team to set up email for the site.
- The form says it's closed: switch on Takes answers, in the form's settings or on its row in Forms.
Domains
Only the site's owner sees Settings → Domains. Each domain there shows where it is:
- Records to add: the records haven't been found at your domain company yet. Compare each one with the table, then wait: it usually takes minutes, sometimes up to a day. Check now asks again at once.
- Certificate pending: the records are right, and the secure (https) certificate is on its way. Nothing to do.
- Needs attention: something is wrong, and the reason shows under the domain. Fix that record, then press Check now.
Many domain companies add your domain to the end of a record's name by themselves. If the table says www.birchwoodcafe.com and the company's form already ends in birchwoodcafe.com, type just www. See Domains.
I need something back
- A moment ago: press Undo (
Ctrl+Z, or⌘+Zon a Mac). - An older version of a page or record: open its History. See History.
- The whole site as it was on a certain day: see Backups.
AI
There is no AI button (the sparkles at the top right of the admin). AI help is off for this site. An owner or admin can switch it on in Settings → AI.
The AI panel says "No AI is connected to this site". AI has to be connected where the site is hosted. Ask your web team.
An assistant (Claude, Claude Code, Cursor and others) can't connect. One test shows whether the key or the assistant's settings are the problem: see Check the connection without an assistant. A key made with Connect never publishes or deletes; that is by design. See API keys for assistants.
Making a site with AI says "Making with AI is not switched on here". That is coming. Use Start without AI: see Making a site.
API errors
- 401: the key is missing, mistyped, revoked or past its end date. Make a new one.
- 403: the key may not do this: another site, a switch that is off, or a collection outside its list. Check its switches under It can.
- 429: too many calls (120 a minute per key, or the key's own daily cap). Wait, then try again.
Use the site's clearcms.app address for the API, even when the site has its own domain. See The API and API keys.
Making a site
- "You have made 3 sites, the most for one person." Write to us if you need more.
- "Too many tries." You can try 5 times an hour. Wait the minutes it says.
- The address is taken: pick one of the free addresses offered, or type another under Change address.
Still stuck?
- In the site admin, Help → About this page explains the screen you are on, with a search.
- Ask the person who set up your site.
- In the Console, the question mark at the top right has Contact us. Your message goes to the Clear CMS team, and we answer by email.