# Common Changes (Cookbook)

## 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`

```yaml
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](/givo/customization/causes-campaigns/).

### Change The Currency Or The Preset Amounts
**File:** `src/content/donate/<language>/-index.md`

```yaml
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](/givo/customization/donation-form/).

### Change Your Phone, Email, Or Address
**File:** `src/config/config.toml`, `[organization]`

```toml
[organization]
  phone        = "+15550100199"   # E.164: + country code, digits only (tel: links)
  phoneDisplay = "(555) 010-0199" # how the number is shown
  email        = "hello@example.org"

  [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](/givo/customization/organization-info/).

### Change Office Hours And Closed Days
**File:** `src/config/config.toml`, `[organization.hours]` and `closedDates`

```toml
[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](/givo/customization/causes-campaigns/#add-a-cause).

### Change The Featured Cause In The Menu
**File:** `src/config/menu.<language>.json`, the Causes item

```json
"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](/givo/customization/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:

```toml
[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](/givo/customization/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](/givo/customization/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](/givo/customization/homepages/#reorder-the-sections).

### 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`):

```yaml
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](/givo/customization/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](/givo/customization/section-layouts/).

### Button Options
Every button in the content files (`button`, `primaryButton`, `secondaryButton`) uses `sharedButton` from `src/sections.schema.ts`:

```yaml
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]`

```toml
[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]`

```toml
[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](/givo/customization/colors-fonts/#background-patterns).

### 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 (<kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>F</kbd>) 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](/givo/features/ai-links-llms/)).
4. Replace the wordmark and favicons: see [Site Identity & Logo](/givo/customization/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`.

<Aside type="tip">
  Can't find where a text comes from? Ask your AI assistant: "Which file sets
  the text '[TEXT]' on the page [URL]?" The [Prompt Library](/givo/ai-customization/prompt-library/)
  has more ready-made prompts.
</Aside>

### Do It With AI
```text
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.
```