Skip to content
New: Customize your theme with an AI assistant. Read the guide

Homepages

Files: src/pages/[...lang]/index.astro, home-residential.astro, home-water.astro, home-commercial.astro, src/content/homepage/english/ · Skill level: Beginner to edit, light code to reorder

Plumbo has four homepages, one per kind of plumbing business. They use the same sections with different content, layouts, header, and footer, so each one also shows which combination suits that business. Keep one as your homepage and delete the others, or keep a second one as a landing page.

HomepageURLRoute fileContent file
Drains and sewer (main)/src/pages/[...lang]/index.astrosrc/content/homepage/english/-index.md
Residential plumbing/home-residential/src/pages/[...lang]/home-residential.astrosrc/content/homepage/english/home-residential.md
Water heaters and water quality/home-water/src/pages/[...lang]/home-water.astrosrc/content/homepage/english/home-water.md
Commercial plumbing/home-commercial/src/pages/[...lang]/home-commercial.astrosrc/content/homepage/english/home-commercial.md

Each content file has a copy in each other language folder, such as src/content/homepage/french/. The Homepages group of the Pages menu links to all four. The three extra homepages ship with robots: "noindex, follow" and excludeFromSitemap: true, so search engines don’t index them.

Drains And Sewer (Main Homepage)

Plumbo main homepage: drains and sewer

For a drain and sewer company. The whole page is warm stone, header and footer included, with a centred headline and a row of rounded photos.

Sections, top to bottom, with the layout set in -index.md:

  1. Hero, strip: centred title, one button, photo row (heroSection)
  2. Client logos, plain (clientsSection)
  3. Services, chips: photo cards with a tag chip and a price chip (servicesSection)
  4. Why choose us, statement: a large centred statement and three figure cards (metricsSection)
  5. How it works, cards (stepsSection)
  6. One large review, single (reviewsSection)
  7. Two ways to book, duo: the first two plans side by side (plansSection)
  8. CTA, panel: a navy rounded block with book and call buttons, above the footer (ctaSection)

Header simple, shown as three floating pills on this page (page-drains in src/styles/v5/home-drains.css), footer columns.

Residential Plumbing

Plumbo residential plumbing homepage

For a plumber who serves homes: leaks, drains, water heaters, and fixtures. A full-bleed photo hero under a floating header, with an orange numbers band over its lower edge.

Sections, top to bottom, with the layout set in home-residential.md:

  1. Hero, photo (heroSection)
  2. Numbers, band: the orange block over the hero’s edge (metricsSection)
  3. Services, photos: 3×2 photo cards (servicesSection)
  4. Why us, bento (whyUsSection)
  5. How it works, photos (stepsSection)
  6. Emergency band, band (ctaSection, shown here in the page instead of above the footer)
  7. Recent jobs, gallery, photos from the projects collection (beforeAfterSection)
  8. Reviews, summary (reviewsSection)
  9. Service areas, chips (areasSection)
  10. About us, checks, with the years badge (featureGridSection)
  11. Get a quote form, quote (contactSection, anchor #quote)
  12. FAQ, default, with a call card (questionsSection)

Header centered (a white rounded bar floating over the hero photo), footer default.

Water Heaters And Water Quality

Plumbo water heaters homepage

For a plumber focused on tank and tankless water heaters, softeners, and filters. A navy brand hero with one framed photo and a call-back card.

  1. Hero, brand (heroSection)
  2. Mission split with a moving strip, mission (featureGridSection)
  3. Numbers, default (metricsSection)
  4. Services, tiles, on the navy block (servicesSection)
  5. Why us, rows (whyUsSection)
  6. Tank or tankless: what each install covers (includedSection, anchor #compare)
  7. Reviews, marquee (reviewsSection)
  8. Team, row, photo cards with a “since” chip (teamGridSection)
  9. FAQ, default (questionsSection)
  10. Emergency band, band (ctaSection)

Header utility (a call strip over a white bar), footer large.

Commercial Plumbing

Plumbo commercial plumbing homepage

For a plumber who looks after restaurants, offices, clinics, shops, and rentals. There is no instant booking: every button leads to the site survey form near the end of the page (#survey) or to the phone.

  1. Hero, panel: grey panel, framed photo, proof row (heroSection)
  2. Commercial sectors, grid, photo cards from the industries collection (industriesStrip)
  3. Services, business (servicesSection)
  4. Permits and certificates, on a grey panel (complianceSection)
  5. Maintenance contract, contract, on the navy block (featureGridSection)
  6. How a job runs, row (stepsSection)
  7. Reviews, carousel (reviewsSection)
  8. Team, portraits (teamGridSection)
  9. Site survey form, walkthrough (contactSection, anchor #survey)
  10. FAQ, card (questionsSection)
  11. CTA, split, above the footer (ctaSection)

Header default, footer minimal. Its primaryCta block turns the header button, the mobile action bar, and the footer’s booking link into “Book a survey” on this page:

primaryCta: # header button, phone bar, and footer booking link on this page (src/lib/primaryCta.ts)
label: "Book a survey"
url: "#survey" # the form near the end of this page
announcement: "hide" # link (swap the bar's booking link) | hide | keep

Reviews On Each Homepage

Every homepage has its own reviewsSection block, and its filter decides which reviews from src/content/reviews/ it shows. Each review file names its service, so a homepage can show only the reviews that match its trade:

src/content/homepage/english/-index.md
reviewsSection:
filter:
service: "" # one service id; empty = every service
services: ["drain-cleaning", "sewer-line-repair"] # used when `service` is empty
limit: 3
HomepageReviews shown
/drain-cleaning, sewer-line-repair
/home-residential/Every review (no filter), 3 in the summary layout
/home-water/water-heater-repair, tankless-water-heaters, water-filtration, leak-detection, pipe-repair
/home-commercial/drain-cleaning, sewer-line-repair, emergency-plumbing

filter also takes area (an area id) to show only reviews from one service area. When you add your own reviews, set their service to one of your service ids so they land on the right homepage. See Reviews & Projects.

How A Homepage Gets Its Content

Each homepage content file holds one named block per section (heroSection:, servicesSection:, …). A block overrides the section’s default file in src/content/sections/english/ for this page only, and picks the section’s look with options.layout:

src/content/homepage/english/-index.md
heroSection: # defaults: hero-section.md
title: "Blocked drains cleared, the same day"
options:
layout: "strip" # default | split | form | band | photo | strip (centred title, one pill, photo row)
  • Objects merge key by key, so a block only needs the fields it changes.
  • A list replaces the whole list: repeat every item you want to keep.
  • enable: false hides that section on this homepage.

To change the text of the main homepage, edit -index.md, not the section files. Change every language. The allowed layouts are in the comment next to each layout:. More in Sections and Section Layouts.

Reorder Or Remove Sections

The order of the sections is set in the route file, not the content file.

The main homepage lists its sections in order near the top of index.astro:

const sections: HomeSection[] = [
{ block: "heroSection" },
{ block: "clientsSection" },
{ block: "servicesSection" },
{ block: "metricsSection" },
{ block: "stepsSection" },
{ block: "reviewsSection" },
{ block: "plansSection" },
];

Each entry names a block of the content file. Reorder the entries to reorder the page, and delete an entry to remove that section, or set enable: false in its block instead, which is easier to undo. Add tone: "sage" to put a section on a panel (the allowed tones are listed in HomeSection in src/layouts/components/HomePage.astro); without tone the section has no panel. A block that is listed here but missing from the content file uses the section file’s defaults. The ctaSection block is not in the list: it is the CTA panel above the footer.

/home-residential/, /home-water/, and /home-commercial/ list their sections in the page, top to bottom. From home-residential.astro:

<Base {...homepageContent?.data} className="framed home-rhythm home-plumbo" footerSpaceTop={false} hideCallToAction layoutSwitcher>
<LayoutVariants section="hero" content={heroSection} />
<MetricsSection content={metricsSection} />
<LayoutVariants section="services" content={servicesSection} />
<WhyUsSection content={whyUsSection} />
<LayoutVariants section="steps" content={stepsSection} />
<LayoutVariants section="cta" content={ctaSection} />
<BeforeAfterSection content={beforeAfterSection} />
<LayoutVariants section="reviews" content={reviewsSection} />
<AreasSection content={areasSection} />
<FeatureGridSection content={featureGridSection} />
<ContactSection content={contactSection} />
<LayoutVariants section="faq" content={questionsSection} />
</Base>

Move a line up or down to move the section. Delete a line to remove it, or set enable: false in its block instead. hideCallToAction stops the page from repeating the CTA above the footer, because this page shows ctaSection in its own place.

In the other homepages, a section wrapped in <SectionBand tone="..."> sits on a panel: sage, mist, or sand for the light grey panel, mint or blush for the peach tint, cream for warm stone, deep and coral for the orange block, and forest for the navy block. /home-water/ puts its services on forest, for example.

Keep the <LayoutVariants section="..." content={...} /> wrapper on the sections that use it (hero, services, steps, plans, reviews, FAQ, CTA). It renders the layout you set in options.layout. Replacing it with the section component itself still works, but leaves the section out of the layout switcher.

Use Another Homepage As Your Homepage

  1. Copy the route. Replace the contents of src/pages/[...lang]/index.astro with the contents of the homepage you want, for example home-water.astro. In the copied code, change the entry name from "home-water" to "-index":

    const entry = await getEntryCTM("homepage", "-index", Astro.currentLocale);
  2. Copy the content. Replace the frontmatter of src/content/homepage/english/-index.md with that of home-water.md. Then delete the robots and excludeFromSitemap lines, and set title: "". The browser title comes from metaTitle, so set that to your homepage title. Do the same in the other language folders.

  3. Delete the homepages you don’t keep: the route files in src/pages/[...lang]/ and the content files in every language folder of homepage/.

  4. Update the menus. Remove the deleted homepages from the Homepages group of the Pages menu in every menu.<language>.json, or turn the whole Pages menu off.

  5. Check it. Run npm run astro-check and open /, /fr/, and /ar/.

Each homepage picks its header and footer in its content file. They win over [settings.layout] in config.toml:

HomepageheaderLayoutfooterLayout
/simplecolumns
/home-residential/centereddefault
/home-water/utilitylarge
/home-commercial/defaultminimal

When you copy a homepage into -index.md, these lines come with it. Delete them to use the site defaults. The centered header is transparent over the photo hero until you scroll, so pair them. The three floating pills of the simple header on / come from pageClass="page-cream page-drains" in index.astro. See Header & Mobile Bar and Footer & CTA Band.

Do It With AI

On the main homepage (src/pages/[...lang]/index.astro), move the [SECTION] entry above the
[SECTION] entry in the sections list and remove the [SECTION] entry. Then rewrite the text of
the hero and services blocks in src/content/homepage/english/-index.md for my business:
[ONE PARAGRAPH]. Keep every key, option, and list length. Do the other language files too.
Make the /home-[residential | water | commercial]/ design my homepage. Replace
src/pages/[...lang]/index.astro with the contents of home-[NAME].astro, reading the "-index"
entry. Copy the frontmatter of src/content/homepage/english/home-[NAME].md into -index.md
(same for the other language folders), remove robots and excludeFromSitemap, and set title to "".
Delete the other homepage routes and content files, remove them from the Homepages group in
each src/config/menu.<language>.json, and run npm run astro-check.
Type something to search...