Support

Direct help for common BaseBuddy setup, access, mapping, editing, and deployment tasks.

Support/How to use SEO and readability checks

How to use SEO and readability checks

Understand BaseBuddy editor checks without treating them as publishing controls or full SEO automation.

Use SEO and readability checks when you want a quick editor review before saving a mapped post.

The checks help you notice common content issues, such as missing focus keyword usage, weak metadata, or readability problems. They do not publish the post, change workflow status, generate search traffic, create schema markup, submit sitemaps, or replace a full SEO platform.

BaseBuddy reads the current post, the saved mapping, and the values visible in the editor. Normal Save still writes dirty mapped fields only. Publish, Unpublish, and Archive remain separate explicit actions.

BaseBuddy editor with a mapped post open and post details in the sidebar
BaseBuddy editor with a mapped post open and post details in the sidebar

Open the checks

  1. Open your BaseBuddy project.
  2. Open Posts.
  3. Open the post you want to review.
  4. Look in the post sidebar for SEO Fields, SEO Analysis, and Readability Analysis.

Your sidebar layout may look different depending on your project's sidebar configuration. Owners and admins can show, hide, group, or reorder supported post sidebar fields from Project Settings -> Sidebar Fields.

If the checks are hidden, ask an owner or admin to review the sidebar configuration. Moving these fields changes the editor layout only. It does not change your database schema, saved mapping, or what Save writes.

Add a focus keyword

SEO Analysis needs a focus keyword and content before it can show checks.

Enter the main keyword or phrase in Focus Keyword, such as content strategy or supabase editor.

If Focus Keyword is mapped to a safe database field, BaseBuddy can save it with the post when you click the main Save button.

If Focus Keyword is not mapped, BaseBuddy can still use it for analysis in this editor. In that case, the field explains that it will not be saved with the post until an owner connects the field. The local value is stored in this browser for that project and post, so another browser or teammate may not see it.

Map a real focus keyword field only if your site stores that value and the mapping has a safe write path. BaseBuddy should not create a new SEO schema or silently reshape your existing tables.

Read SEO Analysis

SEO Analysis reviews the post against the current focus keyword and the fields BaseBuddy can see, such as title, content, excerpt, slug, meta title, and meta description.

The badge can show Good, Needs work, or Poor with a numeric score. Treat this as editing guidance, not a publishing gate.

Some checks appear only when they are useful for your project. For example, site-aware link checks depend on the project website URL, and metadata checks depend on whether the related fields are editable or available as fallbacks.

Use the results to decide what to edit:

Check points atWhere to edit
Focus keywordFocus Keyword
Title or meta titleThe post title or Meta Title
Meta descriptionMeta Description or excerpt
Slug or URL keywordURL Slug, if mapped and editable
Body contentThe main editable content field

If a suggested field is read-only or missing, do not force the edit through another field. Ask an owner to review the mapping, or leave the check as guidance.

Read Readability Analysis

Readability Analysis reviews the current content text. It can run without a focus keyword, but it still needs content.

The badge can show Good, Needs work, or Poor. Use the individual messages to improve clarity, sentence structure, headings, and paragraph flow where they make sense for your post.

Readability checks are suggestions. A technical reference, changelog, legal notice, or short announcement may not need to satisfy every message.

Save only the edits you meant to make

After changing a mapped field, click the main Save or Update button.

Normal Save writes dirty mapped fields only. It should not publish, unpublish, archive, rewrite unrelated SEO fields, convert Markdown or HTML into another storage shape, or change unmapped values.

If you only typed a local focus keyword that is not mapped to database storage, saving the post does not write that keyword to your database.

Workflow actions stay separate. Use Publish, Unpublish, or Archive only when you want to change the mapped workflow status.

Verify the result

For a new mapping or a high-risk post, verify one safe edit before relying on the checks in production.

  1. Open a draft or low-risk post.
  2. Change one mapped field, such as Meta Description or a short excerpt.
  3. Click Save.
  4. Inspect the row in Supabase or your database client.
  5. Confirm only that mapped storage target changed.
  6. Confirm workflow fields changed only if you clicked Publish, Unpublish, or Archive.

Common issues

If SEO Analysis says to add a focus keyword and content, enter a focus keyword and make sure the post has an editable content field with text.

If Readability Analysis says to add content, open a post with readable body content or confirm the content field is mapped.

If Focus Keyword will not save, the field is local to this editor until an owner maps a safe focus keyword field. See How to map SEO fields on BaseBuddy.

If the checks are missing from the sidebar, review Project Settings -> Sidebar Fields. See How to customize your BaseBuddy sidebar.

If a field is read-only, use How to fix a field showing as read-only before editing around it.