Key Concepts
The core building blocks of TDC Site Builder — 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.
- Each workspace has its own subscription plan and quota limits.
- Members can be invited to a workspace and granted roles (Owner, Editor, Viewer).
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.yourdomain.com |
customDomain | Your own domain — e.g. www.example.com (plan-gated) |
domainStatus | pending → verifying → active |
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 |
|---|---|
| Headers | Global site navigation headers |
| Footers | Global site footers |
| Hero | Large headline + subtext + CTA buttons |
| Features | Grids or lists of product/service highlights |
| Bento | Bento-style structured grid layouts |
| Stats | Highlighting key metrics and numbers |
| Testimonials | Customer reviews and quotes with avatars |
| Team | Team directories and staff bios with photos |
| Content | Extended text blocks and article layouts |
| Logo Clouds | 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 |
| Forms | Custom form sections for lead capture |
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/Liquid), Documents, and Dynamic (API data).
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 site settings → Version History.
Restoring a version saves the current state as a new backup first — you can always undo a restore.
Roles & Permissions
Access is controlled at two levels:
| Level | Available Roles | Description |
|---|---|---|
| Workspace Role | Owner, Workspace Admin, Workspace Member | Applies globally to the workspace. Owners and Admins have administrative rights (invites, site creation). Members have contributor rights. |
| Site Role | Site Manager, Site Designer, Site Content Editor, Site Viewer | Specific overrides or assignments for a single site. For example, Site Content Editors can manage content but not billing or domains, while Site Viewers have read-only access. |