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

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 # sample
raised: 48900 # sample
donors: 640 # sample
deadline: 2027-04-30 # remove for an ongoing cause

Write 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 language
amounts:
oneTime: [25, 50, 100, 250, 500]
monthly: [10, 20, 35, 50, 100]
default:
oneTime: 50
monthly: 20

Amounts 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 = closed

Use 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>/

  1. Copy clean-water-wells.md to school-meals.md (the file name becomes /causes/school-meals/).
  2. Change title, description, image, imageAlt, category, goal, raised, donors, deadline, and the body. Remove the # sample values you don’t replace.
  3. Create the file in each other language folder, with the same name and the same numbers.
  4. 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.

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

  1. Delete the route file and every language’s content file of the homepage you don’t want, for example home-community.
  2. Remove its link from the Pages menu in each src/config/menu.<language>.json (or set the whole Pages menu’s "enable" to false).
  3. Run npm run astro-check.

To use a demo homepage as your main home instead, see Homepages.

Hide A Section

  • Everywhere: enable: false at the top of src/content/sections/english/<section>.md (and each other language folder).
  • On one page: add its block to the page file with enable: false, for example questionsSection: then enable: false under 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 | community

The 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 | right

accent (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 footer

Turn Off The Background Patterns

File: src/config/config.toml, [settings]

[settings]
patterns = "none" # organic | none

The 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

  1. In config.toml: [site] title and logoText (both ship as "Givo"), and the [organization] values marked # sample.
  2. In each src/i18n/<language>.json: seo.tagline and seo.siteDescription, which ship with the theme’s own text.
  3. 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).
  4. 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 702
donors]. Use the files named in the Common Changes docs ([organization] in
src/config/config.toml for contact details and hours, src/content/donate/*/-index.md for the
currency and amounts, src/content/causes/*/ for cause figures, with identical numbers in every
language). Remove the # sample comment from each value you replace, then run npm run astro-check.
Type something to search...