General Settings
Configure your site's name, slug, favicon, SEO and AEO/GEO settings for AI search engines, background music, site export, and robots.txt rules.
The General tab is your site's configuration hub. Every change here affects the site globally — from what appears in the browser tab, to how search engines and AI crawlers discover your pages, to the background music visitors hear.
Navigate to your site → General tab.
You need the Manage Settings permission to view and edit this tab. Viewers cannot access it.
Saving Changes
All fields on this page share a single Save Changes button in the top-right corner of the panel. Changes are not applied until you click Save Changes — you can edit multiple fields and save them all in one action.
This includes Site Identity, Favicon, the Floating light/dark button, SEO, AEO & GEO Site Settings, and the Music panel below — one click persists all of them together.
Download Site and Delete site are separate, standalone actions — they are not part of this save and take effect immediately when clicked.
Site Identity - Site Name
| Property | Value |
|---|---|
| Field | Text input |
| Placeholder | "Enter site name" |
| Required | Yes — cannot be saved blank |
| Error | "Site name is required." |
The site name is your internal label — it appears in your dashboard site cards, the browser tab title when editing, and in any places where the site is referenced by name. Renaming the site does not change the slug or domain.
Slug
| Property | Value |
|---|---|
| Field | Text input |
| Placeholder | "site-slug" |
| Required | No |
The slug is the URL-safe identifier used to build your site's default subdomain. For example, a slug of abc generates the domain abc.sites.tdcapps.com.
Changing the slug changes your subdomain URL. Any existing links using the old subdomain will stop working. Update DNS records and notify anyone who has bookmarked the old URL before making this change.
Slug format rules:
- Lowercase letters, numbers, and hyphens only
- No spaces — use hyphens instead (e.g.,
my-site, notmy site) - The new subdomain is shown below the field in real time as you type
Favicon
A favicon is the small icon that appears in browser tabs, bookmarks, and link previews. Blox supports separate favicons for light mode and dark mode so your icon always looks sharp regardless of the visitor's system theme.
Supported Formats & Size
| Requirement | Value |
|---|---|
| Accepted formats | .png, .ico, .svg, .jpg, .webp |
| Recommended size | 64×64 px (square) |
| Maximum file size | 2 MB |
SVG favicons scale perfectly at any size and are the best choice for logos with clean lines. For photo-based icons, use PNG.
Light Mode Favicon
Displayed when the visitor's operating system is in light mode. Click Upload to open the file picker, or drag-and-drop a file onto the upload area.
- The uploaded image appears as a 40×40 px preview on a light background so you can verify it looks correct
- A Remove button appears after uploading — click it to clear the favicon
- You must click Save Changes after uploading to persist the change
Dark Mode Favicon
Identical behaviour to the Light Mode favicon, but displayed when the visitor's OS is in dark mode. The preview renders on a dark background.
If you don't upload a Dark Mode favicon, the browser falls back to the Light Mode favicon — the dark mode field is optional.
Upload Errors
| Situation | Message shown |
|---|---|
| Non-image file selected | "Please choose an image file." |
| File larger than 2 MB | "Image must be 2 MB or smaller." |
Floating light/dark button
A switch below the favicons, off by default. When it is on, your live site shows a small round light/dark toggle in the bottom-right corner whenever visitors can't reach one in the header or footer (for example, the header has no toggle, or it's hidden in a closed mobile menu). When it is off, visitors can switch modes only with a header or footer toggle. Click Save Changes to apply.
Search Engine Optimization (SEO)
This card controls how the whole site appears in Google Search, social previews, and AI crawlers.
Allow Search Engines
| Property | Value |
|---|---|
| Control | Toggle switch |
| Default | On |
When on: Search engines (Google, Bing, etc.) are allowed to crawl and index all pages on this site. This is the correct setting for any live production site.
When off: The server sends an X-Robots-Tag: noindex header on every response. Search engines that respect this header will de-index the site. Use this during development, for staging sites, or for private client sites you don't want appearing in search results.
Turning this off for a site that is already indexed will not immediately remove it from Google. De-indexing happens gradually as search bots re-crawl pages. If you need urgent removal, submit a removal request via Google Search Console.
This toggle also gates /llms.txt and /llms-full.txt — both must be enabled for AI search engines to see your site, even if Enable /llms.txt & /llms-full.txt is on.
Enable sitemap.xml
| Property | Value |
|---|---|
| Control | Toggle switch |
| Default | On |
When on: Blox automatically generates a sitemap.xml file and serves it at https://yoursite.com/sitemap.xml. This file lists all active, indexable pages along with their last-modified date, change frequency, and priority — the exact values set in each page's individual SEO settings.
Submitting this URL to Google Search Console and Bing Webmaster Tools helps search engines discover and index your pages faster.
When off: No sitemap is served. Pages can still be indexed if search bots discover them through links, but it will be slower.
Public Display Name
| Property | Value |
|---|---|
| Field | Text input |
| Placeholder | Your Site Name, or "e.g. TDCCommerce" if the Site Name is blank |
| Required | No |
The brand name shown in Google Search results, social share previews, and structured data (the JSON-LD Organization/WebSite graph embedded on every page). Leave it blank to fall back to the Site Name field above.
Use this when your internal site name (e.g. a project codename) shouldn't be the public-facing brand name search engines and AI assistants see.
Canonical Base Domain
| Property | Value |
|---|---|
| Field | Text input |
| Placeholder | https://myclientsite.com |
| Required | No |
The canonical base domain is the authoritative URL prefix used in:
- All
<link rel="canonical">tags generated for your pages - Sitemap
<loc>entries - The base URL used to build page links in
/llms.txtand/llms-full.txt
When to set this:
If you have a custom domain configured (e.g., https://mycompany.com) and want all canonical tags to reference that domain instead of the auto-generated subdomain, enter it here. This prevents duplicate content issues if your site is accessible from multiple URLs.
Correct format: https://mycompany.com
Not: mycompany.com (missing https://)
Not: https://mycompany.com/ (trailing slash)Leave it blank if you're only using the default subdomain — the subdomain URL will be used automatically.
Disallow Crawling on Specific Pages (Robots.txt)
This subsection lives inside the same SEO card, below Canonical Base Domain, and lets you block search engines from crawling specific pages by adding Disallow rules to your site's robots.txt file.
How it works: each page in your site appears in a scrollable list (its own internal scrollbar once there are more pages than fit) showing its name and slug. Toggle a page on to add it to the disallow list, or off to remove it.
When you Save Changes, the following robots.txt rules are generated automatically:
User-agent: *
Disallow: /page-slug
Disallow: /another-page-slugThese rules tell compliant search bots not to crawl the specified URLs. Already-indexed pages won't be immediately removed — they'll eventually be de-indexed as bots re-crawl.
When to disallow pages:
| Use Case | Pages to Disallow |
|---|---|
| Thank-you / confirmation pages | /thank-you, /order-confirmed |
| Utility pages | /404, /coming-soon |
| Duplicate-content variants | Landing page A/B test variants |
| Internal-only pages | Login-required or password-protected pages |
| Pages under construction | Any page not yet ready for public traffic |
Disallowing a page from robots.txt does not hide it from visitors — the page is still publicly accessible by URL. It only instructs search bots not to crawl it. To hide a page from all visitors, use the Active Status toggle in Page settings instead.
Relationship with per-page noindex: you have two complementary tools for controlling search engine visibility:
| Tool | Where | What it does |
|---|---|---|
| Disallow (robots.txt) | General tab, inside the SEO card | Prevents the bot from even visiting the URL |
| noIndex meta tag | Per-page SEO settings | Allows crawling but tells the bot not to index it |
For maximum exclusion, use both on the same page. For pages where you want to crawl-but-not-index (to pass link equity), use only the per-page noIndex toggle.
AEO & GEO Site Settings
AEO (Answer Engine Optimization) and GEO (Generative Engine Optimization) are the practices of formatting your site so AI assistants — ChatGPT Search, Perplexity, Gemini, Claude — can find, read, and cite it correctly. This card is the site-wide counterpart to the per-page AEO & GEO Optimization fields.
This card appears directly below the SEO card, with a purple accent bar and an "AI Search" badge.
Enable /llms.txt & /llms-full.txt
| Property | Value |
|---|---|
| Control | Toggle switch |
| Default | On |
When on, TDC Site Builder serves two standardized, markdown-formatted knowledge indexes that LLM crawlers can fetch directly instead of parsing rendered HTML:
/llms.txt— a short summary: site name, brand context, a linked list of every crawlable page with its AI summary or meta description, organization/contact details, and your custom notes./llms-full.txt— a longer index: the same plus each page's full AI Key Takeaways (RAG Summary) and AEO Q&A/FAQs (set per-page in Per-Page SEO Settings).
Both files are generated live from your current published content — there's nothing to regenerate manually.
Both files also require Allow search engines to be on. If that toggle is off, /llms.txt and /llms-full.txt return a disabled response even when this toggle is on.
Custom LLMs.txt Notes
| Property | Value |
|---|---|
| Field | Textarea |
| Enabled when | Enable /llms.txt & /llms-full.txt is on (dimmed and disabled otherwise) |
Free-text notes appended to /llms.txt under an "Additional Information" heading — use it for brand instructions, canonical links, or anything else you want an AI assistant to read before it answers questions about your site.
Organization Schema (Brand Entity Graph)
Four optional fields, laid out two per row:
| Field | Feeds into |
|---|---|
| Legal Name | The site-wide JSON-LD Organization node's name, and the "Organization" line in /llms.txt |
| Contact Email | The Organization node's email, and the "Contact Email" line in /llms.txt |
| Phone Number | The Organization node's telephone |
| Business Address | The Organization node's address |
This is the same Organization entity referenced by every page's own JSON-LD graph (see AEO & GEO Optimization) — filling it in once here applies it site-wide. If left blank, the graph falls back to your Site Name with no contact details.
AI Search Crawlers Permissions (Robots.txt)
Four toggles, each allowed by default:
| Bot | Represents |
|---|---|
| GPTBot | OpenAI / ChatGPT Search |
| PerplexityBot | Perplexity AI |
| ClaudeBot | Anthropic |
| Google-Extended | Gemini Search / Google AI features |
Turning a bot off adds a Disallow: / rule for that specific user-agent to robots.txt; leaving it on adds Allow: /. Use this if you want your site indexed by traditional search engines but excluded from a specific AI provider's crawl.
These toggles are separate from Allow search engines above, which governs traditional search bots (Googlebot, Bingbot) via the site-wide X-Robots-Tag header. AI bot permissions are robots.txt-only rules.
Download Site
This card only appears if Site Export & Download feature is enabled on your workspace's plan. If you don't see it in your General tab, the feature isn't available on your current plan.
Exports the site as a portable bundle:
- Complete site schema and published-page snapshots, as JSON
- All referenced media assets (images, audio, video), bundled alongside
- Delivered as a single downloadable ZIP archive
Click Download Site to start the export — the button shows Preparing… while the bundle is built, then your browser downloads the ZIP. This is a standalone action, separate from the Save Changes button above.
Search
Your site's search (the header search bar and Search blocks) updates on its own: publishing, restoring a version, renaming or deactivating a page, unpublishing a post, editing CMS items and changing the site language all update it automatically.
If results ever look out of date, click Rebuild search index. It rebuilds this site's search from its live content: published pages and blog posts, and the CMS items your published pages display. The button shows Rebuilding… while it runs, then reports what was indexed. You can rebuild once a minute. This is a standalone action, separate from the Save Changes button above.
Music
The Music panel appears below the Search card and controls the floating background-music player available to every published page.
Site Music Player
| Property | Value |
|---|---|
| Control | Toggle switch (top-right of the Music card) |
| Default | Off |
Turns the floating music player on or off for the published site. When off, the rest of the Music card is dimmed and disabled, and no player renders for visitors — regardless of how many tracks are configured below.
Player Behavior
| Setting | Description | Default |
|---|---|---|
| Autoplay | Attempts to start playback on page load. Most browsers block autoplay until the visitor interacts with the page, so a play button is always shown as a fallback. | Off |
| Loop playlist | Restarts from the first track after the last one finishes. | Off |
| Enable player controls | Lets visitors click the floating music button to open the full player (seek, skip, volume, track list). When off, the button no longer opens anything. | Off |
| Show track name | Displays the current track's title in the floating music button. | Off |
| Widget position | Left or Right — which side of the screen the floating button appears on. | Right |
Tracks
Click Add Track to add a row. Each track has:
| Field | Notes |
|---|---|
| Track title | Optional — defaults to "Untitled track" if left blank |
| Artist | Optional |
| Audio file URL | Paste a direct http(s) link, or click the upload button to open the asset picker |
Choosing audio: the upload button next to the URL field opens the asset library, filtered to audio files. Upload a new file or pick an existing one from your site's asset library — selecting one fills in the URL automatically (and the title too, if you haven't typed one yet).
Supported upload formats: MP3, WAV, OGG, M4A, AAC, FLAC, up to 50 MB per file.
Reordering: drag a track by its grip handle to reorder the playlist, or focus the handle and use the arrow keys.
Removing: click the trash icon on a track's row to delete it.
A track needs a valid http(s) audio URL to be saved. If a track's URL is invalid, Save Changes is blocked with an error naming the offending track — fix or remove it before saving. Rows left completely empty (no URL) are silently dropped on save.
Music settings are saved together with everything else on the page via the header's Save Changes button — there's no separate save action for the Music panel.
Delete Site
Deleting a site is permanent and irreversible. All pages, sections, blocks, version history, form submissions, blog posts, collections, domain settings, and team members associated with this site will be deleted immediately.
The Delete site section appears at the bottom of the General tab, only visible to users with site management permissions.
Deletion Flow
Click the red Delete site button in the danger zone.
A confirmation dialog opens. Read the warning carefully:
"This action is permanent and cannot be undone. All pages, sections, blocks, version history, and domain settings will be deleted."
In the confirmation field, type your exact site name (case-sensitive) to unlock the delete button. The button remains disabled until the text matches exactly.

Click the red Delete site button in the dialog. The site is deleted immediately and you are redirected to the dashboard.
What Is Deleted
| Data | Deleted? |
|---|---|
| All pages and their content | ✓ Yes |
| All published versions | ✓ Yes |
| All form definitions and submissions | ✓ Yes |
| All blog posts, categories, and tags | ✓ Yes |
| All CMS collections and items | ✓ Yes |
| Custom domain configuration | ✓ Yes |
| Team member site access | ✓ Yes |
| Apps (GTM, GA4, Pixel, custom scripts) | ✓ Yes |
| Music player configuration and playlist | ✓ Yes |
| Uploaded assets (images, files, audio tracks) | ✓ Yes |
Safe Alternative: Hiding the Site
If you're not sure about deleting, use these reversible options instead:
- Deactivate individual pages via the Active Status toggle in Page Manager — visitors get a 404 but no data is lost
- Remove the custom domain to make the site inaccessible from the custom URL while keeping all content
- Revoke team access via the Team tab to prevent further editing
Settings Reference
| Field | Affects |
|---|---|
| Site Name | Dashboard cards, editor browser tab |
| Slug | Default subdomain URL |
| Favicon Light | Browser tab icon in light mode |
| Favicon Dark | Browser tab icon in dark mode |
| Allow Search Engines | Global X-Robots-Tag header, and gates /llms.txt//llms-full.txt |
| Enable sitemap.xml | /sitemap.xml availability |
| Public Display Name | Brand name in search results, social previews, and structured data |
| Canonical Base Domain | All <link rel="canonical"> tags, sitemap <loc> values, and /llms.txt page links |
| Disallowed Pages | robots.txt Disallow entries |
| Enable /llms.txt & /llms-full.txt | /llms.txt and /llms-full.txt availability |
| Custom LLMs.txt Notes | "Additional Information" section of /llms.txt |
| Organization Schema | Site-wide JSON-LD Organization node, and the Organization/Contact lines in /llms.txt |
| AI Search Crawlers Permissions | Per-bot Allow/Disallow rules in robots.txt |
| Site Music Player | Floating music player on the published site |
Related
- Site Overview & Page Manager — Per-page SEO settings that complement the site-wide SEO defaults set here.
- SEO — How search visibility works across TDC Site Builder — metadata, sitemaps, and best practices.
- Domains — Connect a custom domain to use as your Canonical Base Domain.
Site Overview & Page Manager
A complete guide to the site management page — navigating tabs, managing pages, configuring SEO, and collaborating with your team.
Forms
Collect visitor data with no-code forms — configurable fields, spam protection, email notifications, and sync to Mailchimp, HubSpot, and Zendesk.
