Core concepts
This page explains how agencms is organized so the rest of the docs make sense. Read it once and you will know what each term means and where things live.
Owners: personal account vs organization
Every website belongs to an owner. An owner is either your personal account or an organization.
- Your personal account is just you. It is the simplest place to start.
- An organization is a shared owner for working with a team. You create one under Organization settings, invite people, and websites created under the organization are shared with its members.
When you create a website you first choose an owner. If an owner has reached its website capacity, you pick another owner or add capacity through billing. You can switch which owner you are working in from the organization settings page.
Websites
A website is one site you build and publish. It is the top-level container for everything else: pages, posts, templates, themes, media, forms, and settings.
Each website lives in its own workspace at /dashboard/websites/{website}. From the workspace you reach every tool for that site. You manage your list of websites at /dashboard/websites, and a website has its own settings for things like name, slug, and branding.
Pages, posts, and templates
These three are the things you build and put content into.
- Pages are individual pages of your site, like Home, About, or Contact. You compose them in the visual builder. One page is set as the home page.
- Posts are entries that belong to a post type, like blog articles or products. They support translations and previews.
- Templates are reusable layouts for pages and posts. Use a template when you want many pages or posts to share the same structure instead of building each one by hand.
Pages, posts, and templates all keep revisions, so you can review earlier versions of your work.
Post types
A post type defines a kind of content. Blog and product are typical examples. You create post types per website at /dashboard/websites/{website}/post-types, giving each a name, a singular name, and a slug.
Posts are grouped by their post type, and you can organize them further with categories and tags, which you also manage inside the website workspace.
Sections and variants
You build pages, posts, templates, and forms in the visual builder by stacking sections.
- A section is a block on the page, such as a hero, a feature grid, a pricing table, or a footer.
- Sections are grouped into families. A family is one type of section (for example, "hero").
- A variant is a specific design of a family. The same hero family can have several variants, and each variant looks different depending on the active theme.
In the builder you add a section by choosing a family, then pick or switch its variant. Each variant exposes its own fields, which you edit in the panel beside the live preview.
Themes (kits)
A theme controls how your site looks: fonts, colors, and the default templates. Behind each theme is a kit, which is the underlying set of section variants and presets the theme ships with.
Themes are generated by the system per kit, so you do not build a theme from scratch. You manage them at /dashboard/websites/{website}/themes, where you can open a theme to adjust its fonts and colors, then activate one theme as the live look for the website. Switching the active theme re-styles your existing sections to match that kit.
How it all fits together
A quick recap of the hierarchy:
- An owner (your personal account or an organization) holds your websites.
- Each website contains pages, posts, templates, forms, media, and settings.
- Posts belong to post types and can be grouped by categories and tags.
- You build any page, post, or template from sections, choosing a variant of each section family.
- A theme (powered by a kit) sets the fonts, colors, and default look for the whole site.
From here, the rest of the docs walk through each area in detail.