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.mdsrc/content/sections/arabic/reviews-section.mdHow 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: falseat 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 exampleimage: ""hides a photo.
questionsSection: title: "Questions about prices" # replaces the title only options: layout: "grid" # the other options keep their section defaultsCopy 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:
contactSectionneedstitle,description,imagePosition, andform. Copy them fromsrc/content/sections/english/contact-section.md.- A nested object keeps its own required fields: a
buttonneeds alabel. ctaSection,contactSection, andclientsSectionare off unless the block saysenable: true. ActaSection:block that changes only the title hides the call to action band on that page. Start these blocks withenable: 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/.
| Page | Page file (src/content/) | Blocks the page reads |
|---|---|---|
Main homepage / | homepage/english/-index.md | heroSection, clientsSection, servicesSection, metricsSection, stepsSection, reviewsSection, plansSection, ctaSection (the navy panel above the footer) |
Residential /home-residential/ | homepage/english/home-residential.md | heroSection, 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.md | heroSection, featureGridSection, metricsSection, servicesSection, whyUsSection, includedSection, reviewsSection, teamGridSection, questionsSection, ctaSection (the emergency band) |
Commercial /home-commercial/ | homepage/english/home-commercial.md | heroSection, industriesStrip, servicesSection, complianceSection, featureGridSection, stepsSection, reviewsSection, teamGridSection, contactSection, questionsSection, primaryCta |
Services /services/ | services/english/-index.md | servicesSection, includedSection, addOnsSection, industriesStrip, questionsSection |
| Service page | services/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.md | plansSection (the maintenance plans), ratesSection (the rate sheet), includedSection, addOnsSection, estimateSection, questionsSection, jumpNav |
Emergency /emergency/ | pages/english/emergency.md | stepsSection, servicesSection, metricsSection, questionsSection |
Book /book/ | pages/english/book.md | bookingSection, trustStrip, questionsSection |
How it works /how-it-works/ | pages/english/how-it-works.md | stepsSection, trustStrip, includedSection, valuesSection, questionsSection |
Areas /areas/ | areas/english/-index.md | areasSection, reviewsSection, questionsSection |
| Area page | areas/english/<area>.md | servicesSection, reviewsSection, areasSection, beforeAfterSection, questionsSection |
Commercial sectors /industries/ | industries/english/-index.md | contactSection (the walkthrough form) |
| Sector page | industries/english/<industry>.md (plus detail: in -index.md) | includedSection, servicesSection, stepsSection, beforeAfterSection, questionsSection, contactSection |
Reviews /reviews/ | pages/english/reviews.md | reviewsSection |
Projects /projects/ | projects/english/-index.md | beforeAfterSection, reviewsSection |
About /about/ | about-us/english/-index.md | aboutHeroSection, storySection, stepsSection, valuesSection, teamGridSection, careersBandSection |
Team /team/ | team/english/-index.md | teamGridSection, careersBandSection |
Careers /careers/ | careers/english/-index.md | valuesSection, openRolesSection, stepsSection, questionsSection |
Guarantee /guarantee/ | guarantee/english/-index.md | trustStrip, guaranteeClaimSection, stepsSection, complianceSection, questionsSection |
FAQ /faq/ | faq/english/-index.md | questionsSection |
Contact /contact/ | contact/english/-index.md | contactSection, contactOptionsSection, questionsSection |
Specials /specials/ | pages/english/specials.md | plansSection (the coupons), featureGridSection (financing), stepsSection, questionsSection |
Referral /referral/ | pages/english/referral.md | referral, stepsSection, contactSection, questionsSection |
Blog /blog/ | blog/english/-index.mdx | blogListSection, newsletterSection |
| Text pages (legal) | pages/english/<page>.md | contentPage (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 file | Page block | Used on |
|---|---|---|---|
Hero (HeroSection) | hero-section.md | heroSection | All four homepages |
Trust strip (TrustStripSection) | trust-strip.md | trustStrip | /book/, /how-it-works/, /guarantee/. Its rating also feeds the hero and reviews |
Services (ServicesSection) | services-section.md | servicesSection | All four homepages, /services/, /emergency/, service, area, and industry pages |
Steps (StepsSection) | steps-section.md | stepsSection | Main, residential, and commercial homepages, about, how it works, guarantee, careers, emergency, specials, referral, service and industry pages |
Why us (WhyUsSection) | why-us-section.md | whyUsSection | Residential and water heater homepages |
Numbers (MetricsSection) | metrics-section.md | metricsSection | Main, residential, and water heater homepages, /emergency/. Also the numbers on the booking card layout |
Feature rows (FeatureGridSection) | feature-grid-section.md | featureGridSection | Residential, water heater, and commercial homepages, /specials/ (financing) |
Reviews (ReviewsSection) | reviews-section.md | reviewsSection | All four homepages, /reviews/, /areas/, /projects/, service and area pages |
Recent jobs (BeforeAfterSection) | before-after-section.md | beforeAfterSection | Residential homepage, /projects/, service, area, industry, and project pages |
Team (TeamGridSection) | team-grid-section.md | teamGridSection | /team/, /about/, water heater and commercial homepages |
Logos (Clients) | clients.md | clientsSection | Main 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.md | relatedPostsSection | Under each blog post |
FAQ (QuestionsSection) | questions-section.md | questionsSection | Most pages: three homepages, FAQ, contact, book, pricing, emergency, specials, services, areas, and more |
Call to action (CallToAction) | call-to-action.md | ctaSection | Above 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 file | Page block | Used on |
|---|---|---|---|
Instant estimate (EstimateSection) | estimate-section.md | estimateSection | /pricing/, service pages |
Plans (PlansSection) | plans-section.md | plansSection (and ratesSection on /pricing/) | /pricing/ (maintenance plans), /specials/ (coupons), main homepage |
Add-ons (AddOnsSection) | add-ons-section.md | addOnsSection | /pricing/, /services/, service pages |
What’s included (IncludedSection) | included-section.md | includedSection | /pricing/, /services/, /how-it-works/, water heater homepage, service and industry pages |
Booking request (BookingSection) | booking-section.md | bookingSection | /book/ |
Service page hero (ServiceHeroSection) | service-hero-section.md | serviceHeroSection | Service pages |
Not our job (NotCoveredSection) | not-covered-section.md | notCoveredSection | Service pages with the repair template |
Service areas (AreasSection) | areas-section.md | areasSection | /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 file | Page block | Used on |
|---|---|---|---|
Contact (ContactSection) | contact-section.md | contactSection | /contact/, residential and commercial homepages, /industries/, industry pages, referral, commercial service pages |
Contact options (ContactOptionsSection) | contact-options-section.md | contactOptionsSection | /contact/ |
About hero (AboutHeroSection) | about-hero-section.md | aboutHeroSection | /about/ |
Story (StorySection) | story-section.md | storySection | /about/ |
Values (ValuesSection) | values-section.md | valuesSection | /about/, /how-it-works/, /careers/ |
Careers band (CareersBandSection) | careers-band-section.md | careersBandSection | /about/, /team/ |
Open roles (OpenRolesSection) | open-roles-section.md | openRolesSection | /careers/ |
Guarantee claim (GuaranteeClaimSection) | guarantee-claim-section.md | guaranteeClaimSection | /guarantee/ |
Permits and certificates (ComplianceSection) | compliance-section.md | complianceSection | /guarantee/, commercial homepage |
Blog list (BlogListSection) | blog-list-section.md | blogListSection | /blog/, its pages, category and tag pages |
Newsletter (NewsletterSection) | newsletter-section.md | newsletterSection | Blog list pages and posts |
Not found (NotFoundSection) | not-found-section.md | notFoundSection | 404 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:
| Block | Where | What it sets |
|---|---|---|
pageHeader | Any inner page | The page header: eyebrow, description, buttons, phone line, photo or ticket, and its layout. See Section Layouts |
contentPage | Text pages in src/content/pages/ | notice (a callout above the text), summary (a ticket of key facts beside it), and options.numbered |
referral | pages/english/referral.md | The give and get amounts of the referral program |
layoutGallery | pages/english/elements.md | The copy around the /elements/ previews |
jumpNav | pricing/english/-index.md | The sticky row of links under the page header (label, anchor) |
primaryCta | Any page | The 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'scontent file and the block name in docs or in sectionsSchema of src/sections.schema.ts, add a namedblock with only the keys that change (lists must repeat every item I keep), and do the same in theother 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 contentfile in every language folder.