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.
Update What A Cause Has Raised
File: src/content/causes/<language>/<cause>.md
goal: 75000 # sampleraised: 48900 # sampledonors: 640 # sampledeadline: 2027-04-30 # remove for an ongoing causeWrite plain numbers, with no currency sign or commas, and set the same numbers in every language’s file. The progress bar, ”% funded”, and “days left” come from them. “Days left” is counted when the site is built, so rebuild the site (a scheduled daily deploy works) while an appeal runs. Check: the cause page and its card on /causes/. Full guide: Causes & Campaign Progress.
Change The Currency Or The Preset Amounts
File: src/content/donate/<language>/-index.md
currency: "EUR" # ISO 4217 code, one currency for every languageamounts: oneTime: [25, 50, 100, 250, 500] monthly: [10, 20, 35, 50, 100]default: oneTime: 50 monthly: 20Amounts format themselves for each language. Keep every number the same in every language’s file: npm run build prints a [donate] warning when they differ. Change the amounts of impactMap and tiers to match your new currency too. Check: /donate/ and the donation box on the homepage. Full guide: Donation Form.
Change Your Phone, Email, Or Address
File: src/config/config.toml, [organization]
[organization] phone = "+15550100199" # E.164: + country code, digits only (tel: links) phoneDisplay = "(555) 010-0199" # how the number is shown
[organization.address] street = "100 Example Street, Suite 200" locality = "Springfield"The header, footer, contact page, donate fine print, forms, llms.txt, and structured data all read these. Check: the footer and /contact/. See Organization Info.
Change Office Hours And Closed Days
File: src/config/config.toml, [organization.hours] and closedDates
[organization] timezone = "America/New_York" closedDates = ["2026-12-25", "2027-01-01"]
[organization.hours] mon = "09:00-17:00" fri = "09:00-16:00" sat = "" # empty = closedUse 24-hour HH:MM-HH:MM, and "08:00-12:00,13:00-17:00" for a lunch break. Check: the hours on /contact/, and the open-now line of the utility header on /home-community/.
Add A Cause
Folder: src/content/causes/<language>/
- Copy
clean-water-wells.mdtoschool-meals.md(the file name becomes/causes/school-meals/). - Change
title,description,image,imageAlt,category,goal,raised,donors,deadline, and the body. Remove the# samplevalues you don’t replace. - Create the file in each other language folder, with the same name and the same numbers.
- Add its link to the Causes mega menu in each
src/config/menu.<language>.json, in the group of its category.
Check: /causes/, the new cause page, and the Causes menu. Full guide: Causes & Campaign Progress.
Change The Featured Cause In The Menu
File: src/config/menu.<language>.json, the Causes item
"cta": { "enable": true, "eyebrow": "Featured cause", "cause": "school-supplies-for-every-child", "button": { "enable": true, "label": "Donate now", "url": "/donate/?cause=school-supplies-for-every-child" }}Set cause to the file name of a cause, without .md: the card shows its title, progress, and “raised of goal” line. Change the cause id in the button url too. Check: open the Causes menu at desktop width. See Menus.
Change The Donate Button
File: src/config/config.toml, [settings.navigationButton]
The button at the end of the header, also used by the donate bar on phones:
[settings.navigationButton] enable = true label = "" # empty uses navigation.buttonLabel ("Donate") from src/i18n/<language>.json url = "/donate/"To change the words, edit navigation.buttonLabel in each file in src/i18n/. Check: the header at desktop width and the bottom bar at phone width.
Turn On The Appeal Announcement Bar
File: src/content/sections/english/announcement-bar.md
Set enable: true, write label and text (inline Markdown and {phone} work), and set the link, for example to /donate/?cause=<id>. Change id whenever the message changes, so visitors who closed the old one see the new one. start and end (YYYY-MM-DD) limit the days it shows, and hideOn lists pages where it stays hidden (/donate/ by default). To show it on one page only, add an announcementBar: block to that page’s file, as /home-appeal/ does. Check: the strip above the header.
Hide A Demo Homepage
Files: src/pages/[...lang]/home-<name>.astro, src/content/homepage/<language>/home-<name>.md, the menus
- Delete the route file and every language’s content file of the homepage you don’t want, for example
home-community. - Remove its link from the Pages menu in each
src/config/menu.<language>.json(or set the whole Pages menu’s"enable"tofalse). - Run
npm run astro-check.
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(and each other language folder). - 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)
Open the route, src/pages/[...lang]/index.astro (or home-appeal.astro, home-community.astro), and move the section lines. Top to bottom in the file is top to bottom on the page. Keep the <LayoutVariants section="..." content={...} /> lines whole when you move them. See Homepages.
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: "School, clean water and a hot meal, close to home" description: "We fund local teams in four regions..." # sample image: "/images/photos/hero-boys-classroom.jpg" imageAlt: "Pupils raising their hands during a morning lesson" supporters: enable: true label: "1,000+ monthly donors" # sample donate: enable: true cause: "" # a cause id; empty = where the need is greatest options: layout: "photo" # photo | appeal | communityThe supporters line, the quote card, and their photos are samples: replace them with real figures and people who agreed to appear, or set enable: false. Check: the title at phone width: a long title wraps onto more lines. The other hero layouts are in Section Layouts.
Change Or Show A Layout
Set options.layout in the section file or in a page block, for example layout: "list" for the causes section. 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) uses sharedButton from src/sections.schema.ts:
button: enable: true # false hides it without deleting it label: "Give monthly" # required url: "/donate/" # a page, a full https:// address, #section-id, tel:, or mailto: variant: "fill" # fill | ink | soft | outline | link | accent | gold | fill-white | text hoverEffect: "" # "" | text-flip arrow: false # true adds a round arrow button of the same color after the pill target: "" # "_blank" opens a new tab rel: "" class: "" # extra CSS classes icon: enable: true name: "Heart" # any Lucide icon name position: "right" # left | rightaccent (green) is for money actions, gold for the donation band, and fill-white for buttons on photos and forest bands.
Turn Off Dark Mode
File: src/config/config.toml, [settings.colorScheme]
[settings.colorScheme] default = "light" # system | light | dark. Givo ships with light switcher = false # hides the light/dark button in the header, mobile menu, and footerTurn Off The Background Patterns
File: src/config/config.toml, [settings]
[settings] patterns = "none" # organic | noneThe faint hearts, leaves, and waves on the heroes, panels, bands, and footers disappear. To keep them but make them lighter, change --theme-pattern-opacity in src/styles/theme.css. See Colors & Fonts.
Add, Remove, Or Reorder Items In A List
Giving tiers, impact lines, FAQ questions, steps, volunteer roles, form fields, and partner 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, the two buttons, the illustration, and the list of links. Check: open any missing address, such as /nothing-here/.
Change The Number Of Stories Per Page
blogPagination in [settings] of config.toml (6 by default). pagination (8) 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. In a collection’s -index.md, draft: true hides the whole collection.
Replace The Theme Name And Sample Organization
- In
config.toml:[site] titleandlogoText(both ship as"Givo"), and the[organization]values marked# sample. - In each
src/i18n/<language>.json:seo.taglineandseo.siteDescription, which ship with the theme’s own text. - Search the whole project (Ctrl + Shift + F) for
Givo, and change what is visible text. Keep the theme credit in[settings.themeCredit]if you like; it is a separate setting (see AI Links & llms). - Replace the wordmark and favicons: see Site Identity & Logo.
Change Wording That Isn’t In Any Content File
Labels such as “Donate”, “Ended”, “Last day”, “days left”, form errors, and receipt lines 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 Givo site, in every language: [LIST, e.g. phone (555) 123-4567,office hours Mon–Fri 9:00–17:00, currency EUR, the clean water cause has raised 52,300 from 702donors]. Use the files named in the Common Changes docs ([organization] insrc/config/config.toml for contact details and hours, src/content/donate/*/-index.md for thecurrency and amounts, src/content/causes/*/ for cause figures, with identical numbers in everylanguage). Remove the # sample comment from each value you replace, then run npm run astro-check.