SEO & discoverability
SEO (search engine optimization) is about making your pages clear to search engines and appealing when shared. Berrybell has a built-in audit that tells you what's wrong before you have to go looking.
You'll find it in Project settings → SEO & GEO.
Run an audit
Press Run SEO check (or Run check at the top of the panel) to start an audit; after the first one, the button at the top reads Re-check. Running an audit needs the Editor role (see Team & roles). The audit is free, and it runs against your project's own source rather than against a live URL — so it works before you have ever published. It reads every route in the project and comes back with a prioritised list of issues, grouped by page:
- Missing titles, and titles that are too long or too short.
- Missing meta descriptions, or descriptions of the wrong length.
- A missing main heading, or more than one on a page.
- A missing canonical URL.
- Missing social/Open Graph tags, or a missing Twitter card.
- Images with no alt text.
- An accidental
noindexthat would keep the page out of search entirely. - Missing structured data.
The issues are listed on the Your pages tab, AI-readability findings on the GEO tab, and past audits on History.
Health score
Each audit produces a score out of 100, and the History tab charts it from one audit to the next — see History.
The score isn't a plain average of your pages: the home page carries a fixed 40%, and every other route splits the remaining 60%. A broken home page is meant to look broken whether your site has five pages or fifty.
Checks that compare pages
Some problems only exist between pages, so the audit checks those too: two pages sharing a title, a description, a canonical URL, or a main heading.
These deliberately under-report. Where a page's value is the same as the site-wide default, Berrybell can't tell whether the page really declares it or just inherits it from the layout — so it stays quiet rather than raising a duplicate it can't stand behind.
GEO — being readable by AI assistants
The GEO tab asks a different question from the rest of the panel. Not "will Google rank this page?" but "can an AI assistant read this page and quote it?"
Generative-engine optimization — making your content usable by AI answer engines and assistants, the way SEO makes it usable by search engines.
It looks at four kinds of thing:
- Directives that block AI from using the page — snippet, archive and cache restrictions that stop assistants quoting you.
- Missing article and author information, so an assistant can tell what the page is and who wrote it.
- Missing or ambiguous dates, including timestamps with no timezone.
- Structure and consistency — a headline that contradicts the page's own structured data, or a page with no subheadings to break it up.
The GEO tab shows passes and checks that couldn't run, not only failures, so you can see what it actually managed to look at.
History
The History tab is a record of every audit the project has run, newest first. Like the audit, it's free, and anyone in the workspace can read it. Until the first audit, the tab shows the Run SEO check button instead.
At the top, a chart plots the score of each audit in the list below it, oldest on the left, on a fixed 0–100 scale. It starts with the latest 20 and grows as you load older audits. Click a point to open that audit in the list.
The list has one row per audit, 20 at a time, with Load older audits to fetch more. Each row shows:
- when the audit ran, with a Latest or First audit tag where it applies;
- the score and the number of issues, each with its change from the audit before;
- how many issues there were at each severity, and how many were GEO findings.
Open an audit to see which pages it read, everything it reported, and how it compares with the audit before it: New in this audit, No longer reported, how many issues both audits reported, and any pages that were checked last time but not this time.
No longer reported isn't the same as fixed. An issue also leaves when it's traded for a different one on the same page, or when its page stops being checked.
History is read-only. Fixes are sent from Your pages and GEO, which always show the latest audit.
Fixing what it finds
One issue at a time. Any single issue has a fix button that drafts a change against that page's own content and hands it to your project chat in one click. You can edit the drafted text before it goes. Drafting the fix uses AI credits, and so does the chat run that applies it.
"Try fixing all" writes one instruction per file. The panel sends the first message straight away; the rest wait in the run card for you to send one at a time as the chat frees up — the chat won't take a second message while it's still working, and Berrybell deliberately doesn't queue them up behind you.
When the last message has landed and the chat has gone quiet, the panel re-runs the audit and shows you the issue count and score before and after, plus anything new since the run started and any routes that dropped out of the audit. It won't tell you "N issues fixed" — that number can't be measured honestly, and a regression is meant to read as a regression.
The AI makes the edits in your project the way any chat change does, so you can see them and undo them.
What to ask for in the chat
You can also just ask the AI in the chat:
Set the home page title to "Bloom — Fresh flowers, same-day delivery" and add a meta description and a social preview image.
The Publish popover is the other place these live: Site info, in its ⋮ menu, sets your site title, description, favicon and social preview image, and writes them into your app's code.
Make it fast and mobile-friendly
Search engines favor pages that load quickly and work well on phones. When you're building, you can ask the AI to keep the app responsive and lightweight, and to fix anything that feels slow or awkward on mobile in the preview.
After you publish
- Use a custom domain. A branded domain looks more trustworthy in results — see Custom domains.
- Share the link. Check that your social preview looks right when you post the URL.
- Keep content clear. Well-structured, genuinely useful content is the foundation everything else builds on.
- Go further. On a paid plan, a published app also gets crawling of the live site, keyword research, competitor comparison and rank tracking. Unlike the audit, each of those runs uses AI credits — see Advanced SEO tools.