An organization owns sites and audience data. Each site has pages (MDX files) organized in collections (folders). Edits are drafts until you publish. Team members get roles that control what they can change.
Organization
An organization (org) is your workspace on Aveiro. It holds:
All sites you build
Billing and plan limits
Audience data (subscribers, campaigns, segments)
Team members and their roles
One person can belong to multiple organizations — for example, a personal org and a client org. Switch orgs from the header without signing out.
Site
A site is one website project. It has:
A name (for your dashboard)
A preview URL — https://slug.aveiro.page by default
Optional custom domain (configured in editor Settings)
Pages, layout, styles, and settings
Sites are created from a template or blank canvas. Each site is edited independently in the editor.
Page
A page is a single piece of content — stored as an MDX file. Examples:
Homepage (index.mdx)
About page (about.mdx)
A documentation article (guides/quickstart.mdx)
Pages have metadata edited in Page settings:
Field
Purpose
Title
Headline shown in navigation, browser tab, and SEO
Summary
Short description for SEO and social previews
Tag
Single category label on the page
Metadata lives in page settings — not in MDX frontmatter in the editor workflow.
Collection (folder)
Collections are folders in the site file tree. They group related pages — for example, all Getting Started guides under one folder.
Collections can have their own layout and sort order. Nested folders are supported for deeper doc or blog structures.
On docs-style templates, collections often appear in the site sidebar navigation automatically.
Draft vs live
Aveiro separates what you are editing from what visitors see.
State
Meaning
Draft
Your latest edits — visible in the editor and preview, not necessarily on the public URL
Live / Published
A snapshot visitors see on your public site
Publishing can include:
Site settings — SEO defaults, analytics toggle, and similar
Page content — one or more MDX pages you select to go live
A site can show Not live in Settings even when you have been editing for days — that is normal until you publish. Unpublishing hides public content without deleting your drafts.
Do not confuse publish date with going live
Page settings include display fields like a published date or byline for the page chrome. Those are editorial metadata — they do not make the page public. Use Publish in Settings to make content live for visitors.
Preview vs public URL
Editor preview — updates as you edit (draft content)
Preview link — shareable URL with a token so others can review drafts
Public URL — https://slug.aveiro.page (or your custom domain) serves published content only
Unpublished pages are not visible on the public URL — visitors never see draft fallback content for pages you have not published.
Audience vs account
Term
Meaning
Account
You — the person who logs into Aveiro
Subscriber
Someone who opted in via a form on your site (stored in Audience)
Subscribers belong to the organization, not to an individual site, though you can filter by which site they signed up on.
Roles
Organization members have a role that controls access:
Role
Typical access
Owner
Full control including billing and deleting the organization
Admin
Manage members and settings; full operational access
Member
Explicit capabilities and site access — see [Members and permissions](/getting-started/members-and-permissions)
Invitations are sent from Organization → Members. A pending invite must be accepted before the member can access the org.
Templates
A template is a starter site — layout, sample pages, and default styles. When you create a site from a template, Aveiro copies that structure into your new site. You can change everything afterward; the template does not stay linked.
Terminology cheat sheet
Term
One-line definition
Organization
Shared workspace for sites, team, billing, and audience
Site
One website project with its own URL and editor
Page
One MDX document (e.g. a homepage or article)
Collection
Folder grouping pages in the file tree
Publish
Push selected settings and/or pages to the public site
Segment
A label on subscribers for filtering campaigns
Campaign
A one-time email send to a segment or list
Where to go next
Sites overview — managing, duplicating, and archiving sites
