Glossary

The core WordPresto vocabulary, grouped by kind. These are the canonical definitions the product, the assistant and these docs all share.

Concepts

Project

A workspace WordPresto builds intelligence around — either a website or a single piece of writing.

A Project is the unit of work in WordPresto. There are two kinds: a Website Project (a living intelligence model of a domain) and a Writing Project (a living model of a single writing task). Both use the same central Canvas and Worker system. A project must be a persisted record with a real id before project-scoped features run; a temporary domain:example.com intent key is not a project id.

Website Project

A living intelligence model of a domain — its pages, search data, structure and opportunities.

A Website Project progressively learns a domain: discovered pages, titles and metadata, headings, canonical URLs, indexability, internal links and site architecture, plus Search Console, GA4 and Bing metrics, keyword and SERP enrichment (after an explicit action), crawler findings, keyword sets, the topical map, content gaps, cannibalisation candidates and internal-link opportunities. That knowledge is the Project Intelligence that powers Emma, the Workers and Visual Intelligence.

Writing Project

A living intelligence model of a single writing task — its audience, intent, format and constraints.

A Writing Project knows what the user is writing and for whom: audience, intent, format, destination, tone and voice requirements, source material, editorial constraints and approval requirements. It uses the same Canvas and Workers as a Website Project but does not need crawler or domain intelligence.

Related: Project, Canvas

Project Intelligence

The persisted, source-labelled, project-scoped source of truth that powers every WordPresto surface.

Project Intelligence is the shared knowledge layer behind Visual Intelligence, Project Home, Emma, the Workers and the Canvas. Every datapoint is persisted (never client-only), labelled with its source (Search Console, GA4, Bing, keyword enrichment, crawler, page analysis, keyword set, CMS, learning, Canvas decision or worker output) and scoped to a project. Nothing here is invented — a datapoint only exists because a real source produced it.

Project Intelligence Datapoint

One persisted, source-labelled fact about a project.

A datapoint is a single record in the Project Intelligence layer. It carries an id, project id, source and source type, entity type, a label, the relevant URL/query/keyword, optional metrics and relationship JSON, provenance, a confidence and timestamps. Datapoints are never fabricated: an empty result means the source was queried and returned nothing, not that a value was invented.

Canvas

The central rich editor where content is created, reviewed by Workers and approved.

The Canvas is WordPresto’s main work surface — a rich editing environment, not a textarea. Content is created, imported, reconstructed from a live page, edited, proofed, rewritten, reviewed, compared, versioned, approved and prepared for destination handoff here. Its content model is CMS-agnostic so it can map to Astro, Sanity, WordPress and others. The Canvas is the source of approved content; editing approved content returns it to draft/review.

Related: Worker, Approval, Builder Worker

Emma

WordPresto’s assistant — she understands the active project and routes work into the Canvas.

Emma is not decorative chat. She understands the active project, its type and data sources, the current Canvas state, recent worker outputs, approval status and what setup is missing, and she routes content work into the Canvas. She answers from real Project Intelligence and the shipped help guides and glossary rather than guessing, and she can hand off to human support when needed.

Related: Project Intelligence, Canvas

Visual Intelligence

The visible map of a project’s real, persisted intelligence.

Visual Intelligence renders the Project Intelligence layer: source counts, query/page/keyword/URL nodes, and the relationships, gaps and opportunities that are genuinely derived from real data. It never invents nodes, links, clusters, gaps or cannibalisation, and it never shows zero datapoints when real persisted data exists.

Topical Map

The structure of topics and clusters a project genuinely covers, derived from real data.

A Topical Map organises a project’s topics and clusters. It is derived from real Project Intelligence (queries, pages, keywords and their relationships), never invented, and feeds content-gap and internal-link analysis.

Related: Content Gap, Keyword Set

Content Gap

A topic the data shows a project should cover but does not yet.

A Content Gap is a genuine coverage hole, derived from real search and topical data rather than guessed. It points to content worth creating and is surfaced only when the underlying data supports it.

Related: Topical Map, Keyword Set

Cannibalisation

When two or more pages compete for the same query, splitting their performance.

Cannibalisation is when multiple pages on a site target the same query and undercut each other in search. WordPresto surfaces candidates only from real query-to-page data; it does not fabricate findings.

Internal Link Opportunity

A specific, data-backed chance to link one page to another.

An Internal Link Opportunity is a concrete suggestion to link between two of a project’s pages, derived from real page and topical relationships. It supports site structure and helps resolve cannibalisation, and is only shown when the data supports it.

Related: Cannibalisation, Topical Map

Site Health

A score and explorer for the technical state of a crawled site.

Site Health measures the technical state of a site from real crawler findings — status codes, titles, meta descriptions, canonical URLs, indexability and structure. The score is explained honestly (what it measures and what it excludes, such as attachment pages and archives), with an All Pages explorer and a refresh path.

Keyword Set

A named group of keywords a project is working with.

A Keyword Set is a persisted group of keywords scoped to a project, used to focus research, the topical map and content planning. Keywords come from real research; paid keyword enrichment only runs on an explicit action.

Learning

The record of editorial decisions — accepted, rejected and edited suggestions — that teaches WordPresto a project’s preferences.

Learning captures the user’s editorial decisions: accepted and rejected suggestions, manual edits, preferred phrasing, style rules and recurring corrections. It is distinct from provider and crawler facts (which live in Project Intelligence); learning records preferences, not source-of-truth metrics.

Related: Worker, Project Intelligence

Content Brief

A standing editorial directive that governs what WordPresto drafts — project-wide, per channel or per content type.

A Content Brief is a first-class editorial directive, not a one-off instruction. It can govern all content project-wide, one social channel’s posts, or a long-form content type; when several could apply, the most specific governs. Every drafting path — articles, social personas, campaigns and Write with Emma — receives the governing brief verbatim. Briefs can be written directly or uploaded as a file.

Banned Terms

A hard never-use list of words, phrases or symbols enforced in everything WordPresto drafts.

Banned Terms are a project-owned hard rule: words, phrases or symbols the project must never produce. They travel with the same directive channel as the Content Brief, so every drafting path enforces them even when no brief is set.

Related: Content Brief, Voice Profile

Voice Profile

A saved description of how a project sounds, used to check and rewrite copy — always review-only.

A Voice Profile captures a project’s tone and style. The Canvas Voice & Persona panel checks copy against the selected profile and offers review-only rewrite proposals that land as revertable draft versions. Profiles can be created from real writing, set as the project default, or uploaded as a voice file.

Related: Content Brief, Canvas

Target Market

The country (and optional city or region) that scopes keyword, SERP and competitor research.

A Target Market tells WordPresto which country the project’s keyword and competitor research is scoped to, with an optional city or region for local SERP data. Volume, difficulty, SERP and competitor data are country-scoped, so research and AI-visibility cannot run until a market is set — WordPresto never silently assumes one. Setting the market is free.

Credits

The currency for metered actions — a monthly grant plus non-expiring top-up packs.

Credits meter the paid actions: keyword enrichment, rank tracking, competitor analysis, AI visibility checks, AI drafting and some publishing actions. Each plan grants a monthly allowance; top-up packs never expire and are drawn on after the grant. The projected cost is shown before a metered action runs, and an action that would overspend is blocked before anything is charged.

Media Library

Every image in a project — generated or uploaded — stored durably for reuse.

The Media Library holds all of a project’s images. The same generator serves the library page, the Canvas Image tool and campaign posts; in match mode it writes an image prompt from the real copy and never invents brands, statistics or in-image text. Generated images are stored durably in the project and can be browsed, reused and deleted.

Related: Canvas, Campaign

Campaign

A staged batch of social posts, planned and adapted per platform, then committed to the calendar.

A Campaign stages a series of posts on an editable board before anything is scheduled: bring your own batch, ask Emma to draft one, or improve a rough batch. Items are adapted per platform by the channel personas, given images where required, and only scheduled when you push the campaign to the content calendar.

Related: Content Calendar, Social Inbox

Content Calendar

The schedule of social posts queued to publish, in a day, week or month view.

The Content Calendar shows every scheduled social post. While a post is still scheduled it can be moved, rescheduled or cancelled; a dispatcher fires due posts every five minutes through the same publish service as Post now, claiming each post atomically so nothing publishes twice. Statuses are honest: scheduled, posting, posted, failed with the reason, or cancelled.

Related: Campaign, Approval

One merged feed of comments and replies across LinkedIn, X, Facebook and Instagram.

The Social Inbox merges engagement on posts published through WordPresto into one read-only feed, refreshed by a background sweep every fifteen minutes and classified so the comments worth answering are flagged. LinkedIn and X support a full reply flow — draft, approve, then an explicit publish; Facebook and Instagram are fetch-only for now.

Related: Campaign, Content Calendar

AI Visibility

Whether AI answer engines cite your site — measured, scored and closed as gaps.

AI Visibility measures whether answer engines (Google’s AI Overview, ChatGPT, Perplexity) cite the project’s site. Checks are explicit and credit-metered; the Answer Engine panel then scores coverage, share of voice and trend from the persisted history for free, and its gap queue turns weak queries into Canvas remediation drafts whose impact is measured after a verified publish.

Related: Credits, Canvas, Site Signals

Workers

Worker

A specialist agent that reads the project and Canvas, does one task, and returns suggestions for human review.

Workers are specialist agents that operate around the Canvas and Project Intelligence. A Worker reads the active intelligence and current Canvas content, performs one specialist task (drafting, rewriting, proofing, SEO titles, schema, evidence gaps, accessibility, internal links, cannibalisation and more), and returns structured suggestions. Workers never write to external systems silently, never fabricate data and never bypass Canvas approval; accepting, rejecting or editing their output feeds Learning.

Related: Canvas, Builder Worker, Learning

Builder Worker

The Worker that packages approved Canvas content for a chosen destination.

The Builder Worker prepares approved Canvas content for a selected destination, taking the content plus formatting instructions, platform, page/content type, metadata, schema, media, slug and internal-link requirements and CMS field mapping. It outputs a destination-ready package and never invents destination fields — if schema or mapping is missing it returns destination_schema_required or mapping_required.

Related: Canvas, Publishing Agent, Approval

Publishing Agent

A destination-specific agent that hands approved, built content to a CMS such as Astro or Sanity.

A Publishing Agent takes the Builder Worker’s package and hands it to a specific destination — for example the Astro agent (content collections, Markdown/MDX frontmatter) or the Sanity agent (document type, Portable Text, mapped fields). It validates destination requirements, prepares a preview or draft by default, and only publishes live on an explicit action. It never publishes from an unapproved Canvas and never fakes a successful publish.

Related: Builder Worker, Approval

Data sources

Google Search Console

Google’s search-performance source — queries, pages, clicks, impressions, CTR and position.

Search Console is a Google data source WordPresto ingests once the account is connected and a site is mapped to the project. It contributes queries, pages, query-to-page relationships, clicks, impressions, CTR and average position as source-labelled datapoints. If connected but unmapped it shows google_mapping_required; failures return an exact reason (token expired, missing scope, site not selected, and so on). A Search Console site URL is not the same as a GA4 property id.

Google Analytics 4 (GA4)

Google’s analytics source — page views, sessions and engagement.

GA4 is a Google data source ingested once connected and a property is mapped to the project. It contributes pages and views/sessions/engagement over a date range as source-labelled datapoints. A GA4 property id must not be confused with a Search Console site URL.

Bing

A user-owned search source — Bing queries, pages, clicks, impressions and CTR.

Bing is a self-serve search data source. If not configured it shows setup required; if configured but unmapped, mapping required; if mapped, it ingests available Bing search data or returns an exact no-data state. Repeated rows for the same query or URL are aggregated honestly by entity, and duplicate external keys never abort a batch insert.

Keyword & SERP enrichment

Search volume, difficulty, SERP and competitor data added to keywords — only ever run on an explicit, credit-metered action.

Enrichment adds search volume, keyword difficulty, SERP layout and competitor intelligence to a keyword set. It is cost-sensitive, so it never runs on render or automatically during project creation — only when the user explicitly triggers it, metered in credits. The underlying data provider is managed by WordPresto at the platform level, not configured per user, and can be swapped without changing the workflow. Results are persisted as source-labelled datapoints; nothing is fabricated.

Crawler

Core infrastructure that discovers what a website actually contains.

The crawler tells WordPresto what a site really contains: URLs, status codes, titles, meta descriptions, headings, canonical URLs, indexability, internal links, schema presence, page-type guesses, content sections and site structure. Its findings populate Project Intelligence and Site Health. When it cannot run automatically it exposes a clear action-required state rather than faking results.

Site Signals

WordPresto’s own first-party analytics — a snippet you install on your site.

Site Signals is a first-party analytics source: the integration card generates a unique install snippet for the project’s site, and once installed it tracks page views, AI-assistant referral sessions by engine, conversions, outbound clicks, rage clicks, scroll depth and dwell time. A separate server-side key counts AI crawlers, which run no JavaScript. The card shows honestly whether events are arriving.

States

Approval

The gate content must pass before anything leaves the Canvas — persisted and auditable.

Approval means the required review Workers have run, relevant suggestions have been accepted, rejected or resolved, final editorial approval has been given and destination requirements have been checked. It is persisted and auditable (at minimum a status, an approvedAt timestamp and who approved), not client-only. Publishing agents must not write to external systems before approval, and editing the Canvas after approval returns it to draft/review and clears the persisted approval.

Related: Canvas, Draft, Publishing Agent

Draft

Content that has not been approved and must not be published.

Draft is the pre-approval state of Canvas content. AI-generated content is always marked draft until a human approves it, and editing approved content returns it to draft/review. Nothing in a draft state may be handed to a Publishing Agent.

Related: Approval, Canvas