Key Concepts
The core building blocks of Blox — workspaces, sites, pages, sections, and blocks.
Understanding these concepts will make everything else in the docs easier to follow.
Hierarchy
Workspace
└── Sites (multiple per workspace)
├── Pages (multiple per site)
│ └── Sections → Blocks
├── Blog Posts
├── Forms
├── Collections
└── Layout (shared header / footer)Workspace
A Workspace is your top-level organizational unit — typically a company, team, or freelancer account. Everything you create (sites, members, billing) belongs to a workspace.
- You can belong to multiple workspaces.
- Your subscription plan lives on your user account, not on any single workspace — it's shared across every workspace you belong to. Usage and quota limits, however, are tracked per workspace.
- Members can be invited to a workspace and granted roles — see Roles & Permissions below.
Site
A Site is a single website. Each site gets a free subdomain and can optionally have a custom domain attached.
Key site properties:
| Property | Description |
|---|---|
subdomain | Auto-generated from the site name — e.g. my-site.sites.tdcapps.com (a random suffix is appended if the name is already taken) |
customDomain | Your own domain — e.g. www.example.com (plan-gated) |
domainStatus | pending → active (or error if verification fails) |
A site also has a Layout — a shared header and footer that appears on every page.
Page
A Page is a URL within a site. The home page has the slug /, and additional pages have slugs like /about or /pricing.
Each page has:
- SEO settings (including meta title, meta description, keywords, canonical URL, and robots index rules).
- A list of Sections that form the page content.
- A Published Version — a snapshot of the content at publish time.
Section
A Section is a full-width horizontal row on a page. Sections are the main building blocks of a page layout.
Built-in section categories include:
| Category | Description |
|---|---|
| Header | Global site navigation headers |
| Footer | Global site footers |
| Hero | Large headline + subtext + CTA buttons |
| Feature | Grids or lists of product/service highlights |
| Bento | Bento-style structured grid layouts |
| Stats | Highlighting key metrics and numbers |
| Testimonial | Customer reviews and quotes with avatars |
| Team | Team directories and staff bios with photos |
| Content | Extended text blocks and article layouts |
| Logos | Grids showcasing client/partner logos |
| FAQ | Accordion Q&A lists |
| Pricing | Plan comparison tables and billing cards |
| CTA | Eye-catching call-to-action banner sections |
| Form | Custom form sections for lead capture |
See Sections for the complete list.
Block
A Block is an individual content element nested inside section columns. Blocks are the smallest unit of design.
Supported block types include: Text, Rich Text, Image, Video, Button, Card, Group (container), Carousel, Card Carousel, Divider, Form, Hydration (custom HTML with a lightweight Handlebars-like syntax), Documents, and Dynamic (calls an API and renders the response using LiquidJS templates).
See Blocks for every block type and its settings.
Layout (Header / Footer)
The Layout is a site-wide template shared across all pages. It contains the header navigation and footer. Changes to the layout publish separately from individual pages.
Versions
Every time you click Publish, the platform saves a PageVersion snapshot of the full page content. You can restore any previous version from the Version History tab on the site's details page — its own top-level tab there, not nested under a settings tab.
Restoring a version saves the current state as a new backup first — you can always undo a restore. Restoring only updates your editor draft; click Publish afterward to make the restored version live.
Roles & Permissions
Access is controlled at two levels:
| Level | Available Roles | Description |
|---|---|---|
| Workspace Role | Workspace Admin, Workspace Member, Workspace Viewer | Applies globally to the workspace. Admins have administrative rights (invites, site creation, settings). Members have contributor rights. Viewers have read-only access. |
| Site Role | Site Admin, Site Manager, Site Designer, Site Viewer | Specific overrides or assignments for a single site. Site Admins have full control over that site, including removing members and deciding who can publish; Site Managers manage everything else on it; Site Designers can edit content and design but not settings; and Site Viewers have read-only access. |
There's no separate "Owner" role — ownership is a special attribute on the workspace itself (Workspace.ownerId), not a role you assign. The owner automatically gets full Workspace Admin (and Site Admin) rights everywhere, plus the ability to Transfer ownership to another admin or delete the workspace.