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

Sections

Files: src/content/sections/english/ (and each other language folder), page content files · Skill level: Beginner to edit, light code to add or move

A section is one full-width block of a page: the hero, the services, the reviews, the FAQ. Each section is two files that share a name:

src/layouts/components/sections/ReviewsSection.astro ← how it looks (component)
src/content/sections/english/reviews-section.md ← what it says (content)
src/content/sections/french/reviews-section.md
src/content/sections/arabic/reviews-section.md

How Plumbo Works explains the idea in full. This page is the practical reference: every section, its file, and the block name a page uses to change it.

Change A Section Everywhere

Edit its file in src/content/sections/english/ and the file with the same name in each other language folder. The comments in each file list its options and the allowed values.

Section files have no schema, so npm run astro-check doesn’t catch a wrong value in them, such as a misspelled layout. Copy values from the comments, then check the page in the browser.

Hide A Section

  • Everywhere: set enable: false at the top of its section file.

  • On one page: add its block to that page’s content file with enable: false:

    questionsSection:
    enable: false

Change A Section On One Page

Add a named block to the page’s content file with only the keys you want to change. Plumbo merges the block over the section file:

  • Objects merge key by key. A block only needs the fields it changes.
  • Lists replace the whole list. Repeat every item you want to keep.
  • An empty string ("") clears a value, for example image: "" hides a photo.
src/content/pricing/english/-index.md
questionsSection:
title: "Questions about prices" # replaces the title only
options:
layout: "grid" # the other options keep their section defaults

Copy block names exactly from the catalog below (they are the keys of sectionsSchema in src/sections.schema.ts). A block with a wrong name, for example faqSection: instead of questionsSection:, is ignored without an error.

In collections with a schema, npm run astro-check checks the values inside each block before the merge. Most fields are optional there, with these exceptions:

  • contactSection needs title, description, imagePosition, and form. Copy them from src/content/sections/english/contact-section.md.
  • A nested object keeps its own required fields: a button needs a label.
  • ctaSection, contactSection, and clientsSection are off unless the block says enable: true. A ctaSection: block that changes only the title hides the call to action band on that page. Start these blocks with enable: true.

The contact collection (src/content/contact/) has no schema, so blocks in the contact page file are not checked. Open /contact/ after each change.

Blocks Each Page Reads

Every page also reads ctaSection (the call to action band above the footer) and, for inner pages, pageHeader. Paths are for English. The other languages use the same file names in french/ and arabic/.

PagePage file (src/content/)Blocks the page reads
Main homepage /homepage/english/-index.mdheroSection, clientsSection, servicesSection, metricsSection, stepsSection, reviewsSection, plansSection, ctaSection (the navy panel above the footer)
Residential /home-residential/homepage/english/home-residential.mdheroSection, metricsSection, servicesSection, whyUsSection, stepsSection, ctaSection (the emergency band, in the page), beforeAfterSection, reviewsSection, areasSection, featureGridSection, contactSection, questionsSection
Water heaters /home-water/homepage/english/home-water.mdheroSection, featureGridSection, metricsSection, servicesSection, whyUsSection, includedSection, reviewsSection, teamGridSection, questionsSection, ctaSection (the emergency band)
Commercial /home-commercial/homepage/english/home-commercial.mdheroSection, industriesStrip, servicesSection, complianceSection, featureGridSection, stepsSection, reviewsSection, teamGridSection, contactSection, questionsSection, primaryCta
Services /services/services/english/-index.mdservicesSection, includedSection, addOnsSection, industriesStrip, questionsSection
Service pageservices/english/<service>.md (plus detail: and templates: in -index.md)serviceHeroSection, includedSection, notCoveredSection, addOnsSection, estimateSection, stepsSection, reviewsSection, beforeAfterSection, questionsSection, servicesSection, industriesStrip, clientsSection, contactSection
Pricing /pricing/pricing/english/-index.mdplansSection (the maintenance plans), ratesSection (the rate sheet), includedSection, addOnsSection, estimateSection, questionsSection, jumpNav
Emergency /emergency/pages/english/emergency.mdstepsSection, servicesSection, metricsSection, questionsSection
Book /book/pages/english/book.mdbookingSection, trustStrip, questionsSection
How it works /how-it-works/pages/english/how-it-works.mdstepsSection, trustStrip, includedSection, valuesSection, questionsSection
Areas /areas/areas/english/-index.mdareasSection, reviewsSection, questionsSection
Area pageareas/english/<area>.mdservicesSection, reviewsSection, areasSection, beforeAfterSection, questionsSection
Commercial sectors /industries/industries/english/-index.mdcontactSection (the walkthrough form)
Sector pageindustries/english/<industry>.md (plus detail: in -index.md)includedSection, servicesSection, stepsSection, beforeAfterSection, questionsSection, contactSection
Reviews /reviews/pages/english/reviews.mdreviewsSection
Projects /projects/projects/english/-index.mdbeforeAfterSection, reviewsSection
About /about/about-us/english/-index.mdaboutHeroSection, storySection, stepsSection, valuesSection, teamGridSection, careersBandSection
Team /team/team/english/-index.mdteamGridSection, careersBandSection
Careers /careers/careers/english/-index.mdvaluesSection, openRolesSection, stepsSection, questionsSection
Guarantee /guarantee/guarantee/english/-index.mdtrustStrip, guaranteeClaimSection, stepsSection, complianceSection, questionsSection
FAQ /faq/faq/english/-index.mdquestionsSection
Contact /contact/contact/english/-index.mdcontactSection, contactOptionsSection, questionsSection
Specials /specials/pages/english/specials.mdplansSection (the coupons), featureGridSection (financing), stepsSection, questionsSection
Referral /referral/pages/english/referral.mdreferral, stepsSection, contactSection, questionsSection
Blog /blog/blog/english/-index.mdxblogListSection, newsletterSection
Text pages (legal)pages/english/<page>.mdcontentPage (a notice and a summary ticket above the text)

The section order on each page is set in its route file in src/pages/[...lang]/. The main homepage lists its sections in order near the top of its route, src/pages/[...lang]/index.astro. See Homepages.

Section Catalog

Every section, its content file in src/content/sections/<language>/, and the block name a page uses to override it. Layout values are in Section Layouts.

Homepage And Marketing

Section (component)Content filePage blockUsed on
Hero (HeroSection)hero-section.mdheroSectionAll four homepages
Trust strip (TrustStripSection)trust-strip.mdtrustStrip/book/, /how-it-works/, /guarantee/. Its rating also feeds the hero and reviews
Services (ServicesSection)services-section.mdservicesSectionAll four homepages, /services/, /emergency/, service, area, and industry pages
Steps (StepsSection)steps-section.mdstepsSectionMain, residential, and commercial homepages, about, how it works, guarantee, careers, emergency, specials, referral, service and industry pages
Why us (WhyUsSection)why-us-section.mdwhyUsSectionResidential and water heater homepages
Numbers (MetricsSection)metrics-section.mdmetricsSectionMain, residential, and water heater homepages, /emergency/. Also the numbers on the booking card layout
Feature rows (FeatureGridSection)feature-grid-section.mdfeatureGridSectionResidential, water heater, and commercial homepages, /specials/ (financing)
Reviews (ReviewsSection)reviews-section.mdreviewsSectionAll four homepages, /reviews/, /areas/, /projects/, service and area pages
Recent jobs (BeforeAfterSection)before-after-section.mdbeforeAfterSectionResidential homepage, /projects/, service, area, industry, and project pages
Team (TeamGridSection)team-grid-section.mdteamGridSection/team/, /about/, water heater and commercial homepages
Logos (Clients)clients.mdclientsSectionMain homepage, service pages with the commercial template (off unless the block turns it on). Also the logo row of the reviews spotlight layout
Sectors strip (widgets/IndustriesStrip, and sections/industries/IndustriesGrid for grid)none: items from src/content/industries/industriesStrip/services/, service pages, commercial homepage (grid layout)
Blog teaser (RelatedPostsSection)related-posts-section.mdrelatedPostsSectionUnder each blog post
FAQ (QuestionsSection)questions-section.mdquestionsSectionMost pages: three homepages, FAQ, contact, book, pricing, emergency, specials, services, areas, and more
Call to action (CallToAction)call-to-action.mdctaSectionAbove the footer, on pages that turn it on. On the residential and water heater homepages it is the orange emergency band; on the main homepage, the navy panel

Prices, Booking, And Services

Section (component)Content filePage blockUsed on
Instant estimate (EstimateSection)estimate-section.mdestimateSection/pricing/, service pages
Plans (PlansSection)plans-section.mdplansSection (and ratesSection on /pricing/)/pricing/ (maintenance plans), /specials/ (coupons), main homepage
Add-ons (AddOnsSection)add-ons-section.mdaddOnsSection/pricing/, /services/, service pages
What’s included (IncludedSection)included-section.mdincludedSection/pricing/, /services/, /how-it-works/, water heater homepage, service and industry pages
Booking request (BookingSection)booking-section.mdbookingSection/book/
Service page hero (ServiceHeroSection)service-hero-section.mdserviceHeroSectionService pages
Not our job (NotCoveredSection)not-covered-section.mdnotCoveredSectionService pages with the repair template
Service areas (AreasSection)areas-section.mdareasSection/areas/, area pages, residential homepage

The estimator, plans, add-ons, and included lists read their prices and tasks from src/content/pricing/ and src/content/services/, never from the section file. See Pricing & Estimator, Booking Request, Services & What’s Included, and Service Areas.

Company, Contact, And Blog

Section (component)Content filePage blockUsed on
Contact (ContactSection)contact-section.mdcontactSection/contact/, residential and commercial homepages, /industries/, industry pages, referral, commercial service pages
Contact options (ContactOptionsSection)contact-options-section.mdcontactOptionsSection/contact/
About hero (AboutHeroSection)about-hero-section.mdaboutHeroSection/about/
Story (StorySection)story-section.mdstorySection/about/
Values (ValuesSection)values-section.mdvaluesSection/about/, /how-it-works/, /careers/
Careers band (CareersBandSection)careers-band-section.mdcareersBandSection/about/, /team/
Open roles (OpenRolesSection)open-roles-section.mdopenRolesSection/careers/
Guarantee claim (GuaranteeClaimSection)guarantee-claim-section.mdguaranteeClaimSection/guarantee/
Permits and certificates (ComplianceSection)compliance-section.mdcomplianceSection/guarantee/, commercial homepage
Blog list (BlogListSection)blog-list-section.mdblogListSection/blog/, its pages, category and tag pages
Newsletter (NewsletterSection)newsletter-section.mdnewsletterSectionBlog list pages and posts
Not found (NotFoundSection)not-found-section.mdnotFoundSection404 pages, /book/thanks/

Two names don’t follow the pattern: the call to action is CallToAction / call-to-action.md / ctaSection, and the FAQ is QuestionsSection / questions-section.md / questionsSection. The trust strip’s block is trustStrip (no Section).

Two more files in src/content/sections/ belong to site-wide widgets: announcement-bar.md, the optional strip above the header (Header), and cookie-consent.md, the cookie banner (Cookies & Analytics).

Page-Only Blocks

These blocks have no section file. They exist only in page frontmatter:

BlockWhereWhat it sets
pageHeaderAny inner pageThe page header: eyebrow, description, buttons, phone line, photo or ticket, and its layout. See Section Layouts
contentPageText pages in src/content/pages/notice (a callout above the text), summary (a ticket of key facts beside it), and options.numbered
referralpages/english/referral.mdThe give and get amounts of the referral program
layoutGallerypages/english/elements.mdThe copy around the /elements/ previews
jumpNavpricing/english/-index.mdThe sticky row of links under the page header (label, anchor)
primaryCtaAny pageThe main button on this page only: header button, phone action bar, announcement link, and the footer link to the booking page. See Common Changes

Add A Section To A Page

This is a small code edit in the page’s route file in src/pages/[...lang]/.

On the main homepage (index.astro), add one line to the sections list. The order of the list is the order on the page, and tone puts the section on a panel (sage, mint, cream, forest, and the others listed in src/layouts/components/HomePage.astro):

const sections: HomeSection[] = [
{ block: "heroSection" },
{ block: "clientsSection" },
{ block: "estimateSection", tone: "sage" },
// ...
];

Then add the block (for example estimateSection: with enable: true) to the homepage’s content file.

On any other page, including the other three homepages, import the component and place it inside <Base>:

---
import IncludedSection from "@/components/sections/IncludedSection.astro";
---
<IncludedSection content={page?.data.includedSection} />

The hero, services, steps, plans, reviews, FAQ, and CTA are written as <LayoutVariants section="faq" content={questionsSection} /> in the routes. Keep that wrapper when you move them: it renders the section exactly like a direct import, and lets the layout switcher preview it.

Building a brand-new section is a developer task. AGENTS.md and the “Add a new section” recipe in SKILLS.md explain the rules (one .astro component, one content file in each language, and a schema in src/sections.schema.ts), so an AI assistant can do it for you.

Do It With AI

On the page [URL], change the [SECTION] section only for that page: [CHANGES]. Find the page's
content file and the block name in docs or in sectionsSchema of src/sections.schema.ts, add a named
block with only the keys that change (lists must repeat every item I keep), and do the same in the
other language folders. Don't edit src/content/sections/. Then run npm run astro-check.
Add the [SECTION, e.g. estimate] section to [PAGE, e.g. /] after the [OTHER] section.
Follow SKILLS.md: on the main homepage (/) add it to the sections list in index.astro (on other pages,
import the component in the route), then add the block with enable: true to the page's content
file in every language folder.
Type something to search...