Docs
DashboardSite Management

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.

General Settings Panel

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

PropertyValue
FieldText input
Placeholder"Enter site name"
RequiredYes — 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

PropertyValue
FieldText input
Placeholder"site-slug"
RequiredNo

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, not my 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.

Favicon Upload Settings

Supported Formats & Size

RequirementValue
Accepted formats.png, .ico, .svg, .jpg, .webp
Recommended size64×64 px (square)
Maximum file size2 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

SituationMessage 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

PropertyValue
ControlToggle switch
DefaultOn

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

PropertyValue
ControlToggle switch
DefaultOn

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

PropertyValue
FieldText input
PlaceholderYour Site Name, or "e.g. TDCCommerce" if the Site Name is blank
RequiredNo

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

PropertyValue
FieldText input
Placeholderhttps://myclientsite.com
RequiredNo

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.txt and /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-slug

These 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 CasePages to Disallow
Thank-you / confirmation pages/thank-you, /order-confirmed
Utility pages/404, /coming-soon
Duplicate-content variantsLanding page A/B test variants
Internal-only pagesLogin-required or password-protected pages
Pages under constructionAny 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:

ToolWhereWhat it does
Disallow (robots.txt)General tab, inside the SEO cardPrevents the bot from even visiting the URL
noIndex meta tagPer-page SEO settingsAllows 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

PropertyValue
ControlToggle switch
DefaultOn

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

PropertyValue
FieldTextarea
Enabled whenEnable /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:

FieldFeeds into
Legal NameThe site-wide JSON-LD Organization node's name, and the "Organization" line in /llms.txt
Contact EmailThe Organization node's email, and the "Contact Email" line in /llms.txt
Phone NumberThe Organization node's telephone
Business AddressThe 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:

BotRepresents
GPTBotOpenAI / ChatGPT Search
PerplexityBotPerplexity AI
ClaudeBotAnthropic
Google-ExtendedGemini 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.


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

PropertyValue
ControlToggle switch (top-right of the Music card)
DefaultOff

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

SettingDescriptionDefault
AutoplayAttempts 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 playlistRestarts from the first track after the last one finishes.Off
Enable player controlsLets 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 nameDisplays the current track's title in the floating music button.Off
Widget positionLeft or Right — which side of the screen the floating button appears on.Right

Tracks

Click Add Track to add a row. Each track has:

FieldNotes
Track titleOptional — defaults to "Untitled track" if left blank
ArtistOptional
Audio file URLPaste 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

Delete Site Danger Zone

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.

Delete Site Confirmation Dialog

Click the red Delete site button in the dialog. The site is deleted immediately and you are redirected to the dashboard.

What Is Deleted

DataDeleted?
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

FieldAffects
Site NameDashboard cards, editor browser tab
SlugDefault subdomain URL
Favicon LightBrowser tab icon in light mode
Favicon DarkBrowser tab icon in dark mode
Allow Search EnginesGlobal X-Robots-Tag header, and gates /llms.txt//llms-full.txt
Enable sitemap.xml/sitemap.xml availability
Public Display NameBrand name in search results, social previews, and structured data
Canonical Base DomainAll <link rel="canonical"> tags, sitemap <loc> values, and /llms.txt page links
Disallowed Pagesrobots.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 SchemaSite-wide JSON-LD Organization node, and the Organization/Contact lines in /llms.txt
AI Search Crawlers PermissionsPer-bot Allow/Disallow rules in robots.txt
Site Music PlayerFloating music player on the published site

  • 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.