Common Changes
Skill level: Beginner unless marked
Short recipes for the changes people ask about most. Each one names the goal, the file, the change, and what to check. Make every content change in every language folder, and keep npm run dev running to see it.
Change A Price
File: src/content/pricing/<language>/-index.md
Every price on the site (estimator, plans, from-prices on cards, booking summary) is computed from the rate cards, so you change it once:
rateCards: - id: "drain-cleaning" mode: "units" # rooms | hourly | units base: 79 # sample; call-out and setup perUnit: 50 # sample; per drain - id: "pipe-repair" mode: "hourly" hourlyRate: 115 # sample callOutFee: 89 # sample; added once per visitSet the same numbers in every language’s file. Check: /pricing/ and a service page; npm run build prints a [pricing] warning if the files differ. Add-ons are in addOns, and the maintenance plans in plansSection. Full guide: Pricing & Estimator.
Change Your Phone, Email, Or Address
File: src/config/config.toml, [business]
[business] phone = "+15550100199" # E.164: + country code, digits only (tel: links) phoneDisplay = "(555) 010-0199" # how the number is shownThe header, phone bar, footer, contact page, forms, area pages, and structured data all read these. Check: the header call button and /contact/. See Business Info.
Change Opening Hours And Holidays
File: src/config/config.toml, [business.hours] and closedDates
[business] timezone = "America/New_York" closedDates = ["2026-12-25", "2027-01-01"] # no bookings on these days
[business.hours] mon = "07:30-18:00" sat = "08:00-14:00" sun = "" # empty = closedUse 24-hour HH:MM-HH:MM, and "08:00-12:00,13:00-17:00" for a lunch break. Check: the “Open now” line and hours table on /contact/, and that the booking calendar skips closed days.
Add A Service Area
Folder: src/content/areas/<language>/
- Copy
elm-park.mdtolake-view.md(the file name becomes/areas/lake-view/). - Change
title,description,zips,neighborhoods,order, and the body. Remove the# samplevalues you don’t replace. - Create the file in each other language folder, with the same name.
- Add its link to the Areas menu in each
src/config/menu.<language>.json, and update the count in All areas.
The footer column, area finder, and booking ZIP check pick up the new area by themselves. Check: /areas/, and type one of its ZIP codes in the finder. Full guide: Service Areas.
Change The Main Button
File: src/config/config.toml, [settings.navigationButton]
The orange button in the header, also used by the phone action bar:
[settings.navigationButton] enable = true label = "" # empty uses navigation.buttonLabel ("Get a price") from src/i18n/<language>.json url = "/book/"To change the words, edit navigation.buttonLabel in each file in src/i18n/. To change the button on one page only, add a primaryCta block to that page’s file (it changes the header button, phone action bar, announcement link, and the footer link to the booking page), as the commercial homepage does:
primaryCta: label: "Book a survey" url: "#survey" # a section id on the page, or a path announcement: "hide" # link | hide | keep: what the announcement bar does on this pageCheck: the header at desktop width and the bottom bar at phone width.
Hide A Demo Homepage
Files: src/pages/[...lang]/home-<name>.astro, src/content/homepage/english/home-<name>.md (and each other language folder), the menus
- Delete the route file and every language’s content file of the homepage you don’t want, for example
home-commercial. - Remove its link from the Pages menu in each
src/config/menu.<language>.json(or turn the whole Pages menu off). - Run
npm run astro-check.
Homepages don’t read draft, so deleting is the way. To use a demo homepage as your main home instead, see Homepages.
Hide A Section
- Everywhere:
enable: falseat the top ofsrc/content/sections/english/<section>.md. - On one page: add its block to the page file with
enable: false, for examplequestionsSection:thenenable: falseunder it. The block names are in Sections.
Reorder The Homepage(light code)
- The main homepage: open
src/pages/[...lang]/index.astroand reorder the entries of thesectionslist near the top ({ block: "heroSection" }, …). The order of the list is the order on the page. - The other homepages: open the route, for example
src/pages/[...lang]/home-water.astro, and move the section lines inside<Base>. Top to bottom in the file is top to bottom on the page. Keep the<LayoutVariants ... />lines whole when you move them.
Change The Homepage Hero Text Or Photo
File: src/content/homepage/english/-index.md, block heroSection
The main homepage sets its own hero in its file, so edit it there (not in hero-section.md):
heroSection: title: "Blocked drains cleared, the same day" description: "Drain cleaning, hydro-jetting and sewer repair with the price agreed before we start." photos: # `strip`: the row of rounded photos under the copy; four read best - image: "/images/heroes/strip-1.jpg" # src/assets/images/heroes/strip-1.jpg alt: "Two copper supply pipes in an open wall" - image: "/images/heroes/strip-2.jpg" alt: "Water running from a shower head" - image: "/images/heroes/strip-3.jpg" alt: "Brass valves and fittings on a pipe run" - image: "/images/heroes/strip-4.jpg" alt: "A brass handheld shower on a marble wall" options: layout: "strip"photos is a list, so repeat every photo you keep.
Check: the title at phone width: a long title wraps onto more lines. The other hero layouts are in Section Layouts.
Change The Rating And Trust Facts
File: src/content/sections/english/trust-strip.md
rating.value and rating.count feed every rating chip, line, and summary on the site, and facts the licence, insurance, and guarantee facts. Use real figures from your review sources, or set rating.enable: false.
Change Or Show A Layout
Set options.layout in the section file or in a page block, for example layout: "carousel" for the reviews. Allowed values are in the comment next to layout: and on /elements/. See Section Layouts.
Button Options
Every button in the content files (button, primaryButton, secondaryButton, submitButton) uses sharedButton from src/sections.schema.ts:
button: enable: true # false hides it without deleting it label: "Book a plumber" # required url: "/book/" # a page, a full https:// address, #section-id, tel:, or mailto: variant: "fill" # fill | soft | outline | accent | fill-white | text hoverEffect: "" # "" | text-flip target: "" # "_blank" opens a new tab (links to other sites do this on their own) rel: "" class: "" # extra CSS classes, for example "w-full justify-center" icon: enable: true name: "ArrowRight" # any Lucide icon name position: "right" # left | rightUse accent for at most one button per view. fill-white is for buttons on photos and dark bands.
Turn On The Announcement Bar
File: src/content/sections/english/announcement-bar.md
Set enable: true, write text (Markdown and {phone} work), and set a link. Change id whenever the message changes, so visitors who closed the old one see the new one. end: "2026-10-31" hides it after that day. Check: the strip above the header.
Change The Currency
File: src/config/config.toml, [settings.estimator]
[settings.estimator] currency = "EUR" # ISO 4217 code, one currency for every language currencyDisplay = "symbol" # symbol | narrowSymbol | codePrices format themselves for each language. Change the numbers in the pricing file to your own prices too.
Turn Off Dark Mode
File: src/config/config.toml, [settings.colorScheme]
[settings.colorScheme] default = "light" # system | light | dark. Plumbo ships with light switcher = false # hides the light/dark button in the header, mobile menu, and footerAdd, Remove, Or Reorder Items In A List
Plans, FAQ questions, steps, facts, form fields, and logos are YAML lists. Each item starts with - . Copy a whole item (from its - to the line before the next -) to add one, delete it to remove one, and move it to reorder. Keep the indentation exactly as in the other items. In a page block, a list replaces the whole list from the section file: repeat every item you keep.
Change The 404 Page
File: src/content/sections/english/not-found-section.md
The title, text, buttons, photo, and the “Or call” line. Check: open any missing address, such as /nothing-here/.
Change The Number Of Posts Per Page
blogPagination in [settings] of config.toml (6 by default). pagination sets the other paginated lists.
Hide A Page Without Deleting It
Add draft: true to its frontmatter. It stays visible in npm run dev so you can keep working on it, and is left out of the built site, the sitemap, and llms.txt.
Replace The Theme Name And Sample Brand
- In
config.toml:[site] title,description,tagline, andlogoText(ships as"Plumbo"), and[business] name. - Search the whole project (Ctrl + Shift + F) for
Plumbo, and change what is visible text. - Replace the logo mark and favicons: see Site Identity & Logo.
Change Wording That Isn’t In Any Content File
Labels such as “Get a price”, “Call”, “All services”, form errors, booking steps, and units live in src/i18n/<language>.json. Search those files for the words you see, and change each one. Then run npm run check-i18n.
Do It With AI
Make these changes to my Plumbo site, in every language: [LIST, e.g. phone (555) 123-4567,hours Mon–Fri 8:00–17:00, Saturday closed, drain cleaning base price 89]. Use the files named inthe Common Changes docs ([business] in src/config/config.toml for contact details and hours,src/content/pricing/*/-index.md for prices, with identical numbers in every language). Remove the# sample comment from each value you replace, then run npm run astro-check.