Skip to content
TheHVACMarketing Guys

How your site looks

See your whole site setup, change your colors with a preview, place your photos, and arrange your homepage.

Overview

Your site's look is more than its words. It's your colors, your photos, and the order your homepage tells your story in. Your assistant can change those too. It starts by reading your whole setup at once, so it knows what's there before it touches anything.

New colors come with a preview. Ask for a color, or ask it to take your colors from your logo, and you get a link to look at first. It won't save colors that make text hard to read. It tells you which color failed and by how much, so you can pick another.

Photos go where you say. Each one is checked for size and sharpness first. An empty spot shows a plain photo of the kind of work you do, never a stock photo of somebody else's business.

You can move homepage sections around, hide one, and pick what shows next to your logo. The big photo at the top always stays first.

Your logo, services, menu, buttons, trust points, shop awards and business facts stay with us. Ask, and we'll change them.

Changes here need an active account. If your account is on hold or cancelled, editing pauses until it's back.

The tools on this page

How your site looks: what each tool reads, writes, and asks
ToolReadsWritesAsks you first
See your site setupYesNoNo
Change site photosNoYesYes
Arrange your homepageNoYesYes
Change your colorsNoYesYes

See your site setup

get_site_setupReads only

What you can ask

  • What does my website look like right now?
  • Which photos and colors is my site using?
  • Do my hours match everywhere?

What it does

Your site's setup in one read: colors, logo, photos, trust points, buttons, services and hours. Read this before changing any of them.

What it won't do

It only reads. Nothing changes until you ask for a change.

What your assistant sends

Nothing. Your assistant just runs it.

Example: what your assistant sends
{}
Example: what comes back
{
  "theme": {
    "preset": {
      "id": "professional",
      "name": "Professional"
    },
    "brand": {
      "primary": "#1F6F3A",
      "secondary": "#1F2937",
      "accent": "#C2410C"
    },
    "tokens": [
      {
        "key": "brand",
        "label": "Brand color",
        "value": "#1F6F3A",
        "source": "preset"
      }
    ]
  },
  "logo": {
    "primary": "https://cdn.example/logo.png",
    "dark": "https://cdn.example/logo.png",
    "favicon": "https://cdn.example/favicon.png"
  },
  "images": [
    {
      "slot": "hero",
      "label": "Homepage hero",
      "url": null,
      "renders": "/floor/shared/contact.jpg",
      "source": "floor",
      "human_set": false,
      "focal": null
    }
  ],
  "trust_bar": {
    "points": [
      {
        "id": "licensed",
        "text": "Licensed and insured",
        "subtext": null
      }
    ],
    "emergency_message": null
  },
  "header": {
    "cta_right": {
      "text": "Book online",
      "action": "schedule",
      "url": null,
      "open_in_new_tab": null,
      "enabled": null
    },
    "services": [],
    "hidden_items": [],
    "display": null
  },
  "hero": {
    "cta_primary": null,
    "scheduler_enabled": true
  },
  "booking": {
    "vendor": null,
    "enabled": false,
    "embed_key": null,
    "detected_vendor": null
  },
  "warranty": {
    "enabled": false,
    "program_name": null
  },
  "socials": {
    "links": [
      {
        "network": "facebook",
        "url": "https://facebook.com/example"
      }
    ],
    "same_as": [
      "https://facebook.com/example"
    ]
  },
  "services": [
    {
      "slug": "water-heater-repair",
      "name": "Water heater repair",
      "enabled": true,
      "homepage_card": true,
      "order": 0,
      "card_image": null
    }
  ],
  "hours": {
    "stored": {
      "monday": "08:00-17:00",
      "saturday": "closed"
    },
    "source": null,
    "gbp": {
      "monday": "08:00-17:00",
      "saturday": "08:00-12:00"
    },
    "site": null,
    "conflicts": [
      {
        "day": "saturday",
        "stored": "closed",
        "gbp": "08:00-12:00",
        "site": null
      }
    ]
  },
  "year_established": 2004,
  "layout": {
    "hero_variant": null,
    "section_order": [],
    "hidden": [],
    "header_display": null
  },
  "human_set": []
}

Change site photos

set_imagesChanges your site or sends something

What you can ask

  • Put the photo of our shop on the homepage.
  • Fill the empty photo spots on my site.
  • Use my new photo for the about page.

What it does

Put photos from your library on your homepage, about page and service cards, or fill empty spots. Each photo is checked for size and sharpness first.

Your assistant asks you to confirm this first.

What it won't do

Photos that are small, blurry, too dark, or an odd shape aren't placed. You'll hear which one and why, and nothing else changes. A phone shows only part of a wide photo, so you can also choose which part stays in view.

What your assistant sends

FieldRequiredDescription
slotsarray of objectNoLibrary photos for slots. Each must pass the photo check (size, shape, not dark or flat).
fill_fromone of: gated_photos, floorNoFill the EMPTY slots: gated_photos uses the checked Google photos, floor the trade images.
idempotency_keystringNoOptional. Reusing a key within 24 hours returns the first result instead of writing again.
confirmobjectNoRequired to apply a change. Not needed for a preview.
owner_requeststringNoWhat the owner asked for, in their words, one sentence. Optional. Stored with the audit record so their team can see what owners ask for.
Example: what your assistant sends
{
  "fill_from": "floor",
  "confirm": {
    "intent": "Fill the empty photo spots"
  }
}
Example: what comes back
{
  "written": [
    {
      "slot": "about",
      "service_slug": null,
      "url": "/floor/shared/contact.jpg",
      "source": "floor"
    }
  ],
  "skipped": [],
  "before": {
    "assets.about.hero": null
  },
  "after": {
    "assets.about.hero": "/floor/shared/contact.jpg"
  }
}

Arrange your homepage

set_layoutChanges your site or sends something

What you can ask

  • Move the reviews higher on my homepage.
  • Hide the questions section on my homepage.
  • Show my rating next to the logo instead of my town.

What it does

Reorder or hide the sections of your homepage, pick the hero style, and choose what the header shows next to your logo. The hero always stays first.

Your assistant asks you to confirm this first.

What it won't do

The big photo at the top always stays first. A section with nothing in it stays hidden either way.

What your assistant sends

FieldRequiredDescription
modeone of: preview, applyNoapply (default) saves. preview writes nothing and returns a link that shows the change (with the hero layout and every section switch) on the live homepage.
preview_ttl_minutesintegerNoStaff only: how long the preview link lasts, in minutes (up to 10080, 7 days). Default 30. Ignored for owners.
hero_variantone of: photo, full_bleed, video_loop or nullNo
section_orderarray of enumNo
hiddenarray of enumNo
header_displayone of: location, reviews or nullNo
hero_layoutone of: default, centered-pull-in, billboard or nullNo"centered-pull-in": centered copy over the photo, the trust points as a line, the scheduler as a wide card over the bottom edge. "billboard": oversized caps over the hero photo with an accent third line and the rating figure, a scrolling strip of your own services, the billboard services grid with a specialty card, a reviews band that carries the why-choose claims, a crew band (with a crew photo), find the shop with a brand visit card, a heading-left FAQ and the final booking band on the accent color. On every page: the phone bar always visible, the footer emergency strip hidden. Each switchable per section below. English pages only.
video_tour_toneone of: light, dark or nullNo
show_addressboolean or nullNo
services_stripboolean or nullNoThe scrolling strip of your own services under the hero (needs three or more homepage services). null: follow the hero again.
services_layoutone of: default, centered, billboard or nullNoThe services section. null: follow the hero again.
reviews_layoutone of: default, pull-in, band or nullNoThe reviews section. "band" needs three real reviews, else the default shows. null: follow the hero again.
crewboolean or nullNoThe crew band (needs a crew photo, set_images slot crew). null: follow the hero again.
faqs_layoutone of: default, pull-in, heading-left or nullNoThe FAQ section. null: follow the hero again.
final_cta_bandone of: default, accent or nullNoThe final booking band: "accent" sets it on the accent color. null: follow the hero again.
service_map_card_toneone of: surface, brand or nullNoFind the shop's visit card. null: follow the hero again.
mobile_bar_visibilityone of: after-hero, always or nullNoThe phone bar on every page: "always" shows it from the first screen. null: follow the hero again.
footer_emergency_stripone of: show, hide or nullNoThe footer emergency strip on every page. null: follow the hero again.
hero_ratingboolean or nullNoThe rating figure in the billboard hero (only above the review display floor). null: follow the hero again.
idempotency_keystringNoOptional. Reusing a key within 24 hours returns the first result instead of writing again.
confirmobjectNoRequired to apply a change. Not needed for a preview.
owner_requeststringNoWhat the owner asked for, in their words, one sentence. Optional. Stored with the audit record so their team can see what owners ask for.
Example: what your assistant sends
{
  "header_display": "reviews",
  "confirm": {
    "intent": "Show our rating in the header"
  }
}
Example: what comes back
{
  "before": {
    "layout.header.display": null
  },
  "after": {
    "layout.header.display": "reviews"
  }
}

Change your colors

set_themeChanges your site or sends something

What you can ask

  • Make my site match the colors in my logo.
  • Use this green for the buttons on my site.
  • Show me my site in darker colors before you change it.

What it does

Change your site's colors. It checks that text stays readable. Preview first: you get a link to look at before anything is saved. It can also suggest colors from your logo.

Your assistant asks you to confirm this first.

What it won't do

It won't save colors that make text hard to read. You'll see which color failed and by how much, so you can pick another.

What your assistant sends

FieldRequiredDescription
modeone of: preview, applyNopreview (default) returns a preview link and writes nothing; apply saves.
paletteobjectNoThe three brand colors: primary (buttons, links), secondary (dark ink), accent.
tokensobjectNoOther theme tokens, e.g. { "radius": 8 }. Every key and what it accepts: brand (hex color like #1d4ed8); brandInk (hex color like #1d4ed8); accent (hex color like #1d4ed8); accentInk (hex color like #1d4ed8); ink (hex color like #1d4ed8); surface (hex color like #1d4ed8); surfaceAlt (hex color like #1d4ed8); scrim (hex color like #1d4ed8, or var(--brand)); scrimStrength (number from 0.2 to 0.6); success (hex color like #1d4ed8); warning (hex color like #1d4ed8); danger (hex color like #1d4ed8); rating (hex color like #1d4ed8); cta (hex color like #1d4ed8, or one of: var(--brand), var(--brand-ink), var(--accent), var(--accent-ink), var(--ink), var(--surface)); ctaInk (hex color like #1d4ed8, or one of: var(--brand), var(--brand-ink), var(--accent), var(--accent-ink), var(--ink), var(--surface)); kickerColor (hex color like #1d4ed8, or one of: var(--brand), var(--brand-ink), var(--accent), var(--accent-ink), var(--ink), var(--surface)); kickerFont (one of: heading, body, mono); radius (number from 0 to 9999 (pixels)); radiusControl (number from 0 to 9999 (pixels)); radiusInput (number from 0 to 9999 (pixels)); radiusCard (number from 0 to 9999 (pixels)); radiusMedia (number from 0 to 9999 (pixels)); fontHeading (heading font name, one of: system-ui, -apple-system, sans-serif, Plus Jakarta Sans, DM Sans, DM Serif Display, Manrope, Sora, Albert Sans, Outfit, General Sans, Inter, Space Grotesk, Geist, Instrument Sans, Hanken Grotesk, Schibsted Grotesk, Bricolage Grotesque, Archivo, Barlow, Public Sans, Fraunces, Source Serif 4, Newsreader, Instrument Serif, Bitter, Oswald, Barlow Condensed, Anton, Saira Condensed, Roboto Slab, Zilla Slab, Nunito Sans); fontBody (body font name, one of: system-ui, -apple-system, sans-serif, Plus Jakarta Sans, DM Sans, DM Serif Display, Manrope, Sora, Albert Sans, Outfit, General Sans, Inter, Space Grotesk, Geist, Instrument Sans, Hanken Grotesk, Schibsted Grotesk, Bricolage Grotesque, Archivo, Barlow, Public Sans, Fraunces, Source Serif 4, Newsreader, Instrument Serif, Bitter, Oswald, Barlow Condensed, Anton, Saira Condensed, Roboto Slab, Zilla Slab, Nunito Sans); displayScale (number from 0.9 to 1.4); headingWeight (one of: 400, 600, 700, 800); headingTracking (one of: normal, -0.01em, -0.02em); kickerTransform (one of: none, uppercase); titleTransform (one of: none, uppercase); titleLeading (number from 0.9 to 1.6); iconMode (one of: none, minimal, filled); elevation (one of: flat, hairline, soft); imageFrame (one of: full-bleed, inset); trustBarMode (one of: logos, points); texture (one of: none, pinstripe, tonal, columns, scanfade, grid, edges, lift, depth, inset, grain, brushed, halftone, diamond, contour); density (one of: airy, standard, compact); sectionY (length in px or rem, like 4rem or 24px); cardPad (length in px or rem, like 4rem or 24px); motion (one of: calm, standard); headerTone (one of: light, dark); footerTone (one of: light, dark, brand); serviceCardLayout (one of: stacked, overlay); fontLabel (label font name, one of: kicker, IBM Plex Mono); labelTracking (one of: 0.06em, 0.08em, 0.1em, 0.12em); headingAccent (one of: none, accent-color); photoTreatment (one of: none, mono-grain); brandTexture (one of: none, pinstripe, tonal, columns, scanfade, grid, edges, lift, depth, inset, grain, brushed, halftone, diamond, contour); tint (hex color like #1d4ed8); kickers (one of: show, hide); containerWidth (one of: standard, wide); logoSize (one of: standard, large). Keys or values it does not accept are dropped and named, with what is allowed.
from_logobooleanNotrue proposes the palette from the stored logo; a palette sent with it wins per color.
cleararray of stringNoTheme token keys to remove from the saved theme on apply, so they go back to the brand colors and defaults, e.g. ["radius"]. A key cannot be both set and cleared.
hero_layoutone of: default, centered-pull-in, billboardNoPreview only: show the colors on this hero layout in the same link (e.g. "billboard"). Saving a layout is set_layout.
preview_ttl_minutesintegerNoStaff only: how long the preview link lasts, in minutes (up to 10080, 7 days). Default 30. Ignored for owners.
idempotency_keystringNoOptional. Reusing a key within 24 hours returns the first result instead of writing again.
confirmobjectNoRequired to apply a change. Not needed for a preview.
owner_requeststringNoWhat the owner asked for, in their words, one sentence. Optional. Stored with the audit record so their team can see what owners ask for.
Example: what your assistant sends
{
  "palette": {
    "primary": "#1F6F3A"
  },
  "mode": "apply",
  "confirm": {
    "intent": "Use our logo green for the buttons"
  }
}
Example: what comes back
{
  "mode": "apply",
  "applied": true,
  "proposal": null,
  "palette": {
    "primary": "#1F6F3A",
    "secondary": null,
    "accent": null
  },
  "tokens": {},
  "dropped": [],
  "contrast": {
    "pass": true,
    "checks": [
      {
        "check": "brand color on a white page",
        "ratio": 6.43,
        "min": 3,
        "pass": true
      }
    ]
  },
  "before": {
    "branding.primaryColor": "#0F766E",
    "theme.overrides": {}
  },
  "after": {
    "branding.primaryColor": "#1F6F3A",
    "theme.overrides": {
      "brand": "#1F6F3A"
    }
  }
}