# Footer & Closing Band

## Footer & Closing Band

**Files:** `src/config/config.toml`, `src/i18n/<language>.json`, `src/config/menu.<language>.json`, `src/config/social.json`, `src/content/sections/english/call-to-action.md` · **Skill level:** Beginner

The footer closes every page with your links, your organization's details and registration number, a newsletter signup, social links, the legal row, a row of Ask AI links, and the theme credit. Givo has three footer layouts. Above the footer, a page can also show a **closing band**: a call to action to volunteer or give.

<div class="border border-dark">
  ![Givo default footer on a forest band](/images/givo/footer.jpg)
</div>

### Choose A Footer Layout
```toml
# src/config/config.toml
[settings.layout]
  # default | minimal | large
  footer = "default"
```

| Layout    | What it shows                                                                                         | Demo page          |
| --------- | ----------------------------------------------------------------------------------------------------- | ------------------ |
| `default` | A forest-green band. A newsletter line and form on top, then the wordmark, the description, your address, email, phone, registration number, and social icons beside the link columns. A row of accreditations, then the copyright, the legal links, and the language and light/dark switches | `/` and the inner pages |
| `minimal` | A light footer under a thin line: the wordmark and registration number, a one-line statement, the first two link columns and the social links, a signup row, then the copyright, the legal links, and the language switch | `/home-appeal/` |
| `large`   | A white footer: your organization block (name, address, phone, email, registration number, and the Donate button), the office hours one row per day with today marked, the link columns, then the legal line | `/home-community/` |

**One page, another layout.** Add `footerLayout` to the page's frontmatter. It wins over the config:

```yaml
---
title: "Flood appeal"
footerLayout: "minimal" # default | minimal | large
---
```

The emergency appeal homepage uses `minimal` this way, and the community homepage uses `large`.

### Footer Text
The short texts are UI strings in `src/i18n/<language>.json`, under `footer`:

| Key                     | Shipped English text                                       | Used by                     |
| ----------------------- | ---------------------------------------------------------- | --------------------------- |
| `footer.description`    | "We fund local programs for food, schooling, and safe homes, and report every dollar." | `default` (under the wordmark), `minimal` (the statement), and `large` |
| `footer.registration`   | "Registered charity no. \{number\}"                        | Every layout. `{number}` is `[organization] registrationNumber` |
| `footer.legalLine`      | "\{name\} is a registered charity (no. \{number\}). Registered office: \{address\}." | The legal line of every layout, when a registration number is set |
| `footer.accreditations` | Four sample lines separated by `\|`                        | The accreditations row of the `default` footer. `""` hides the row |
| `footer.socialsTitle`, `footer.contact` | "Follow us", "Contact"                     | Headings                    |
| `footer.copyright`      | "© \{year\} \{brand\}. All rights reserved."               | Every layout                |

The accreditations ("Charity regulator: registered", "Fundraising standards: member", and so on) are samples. Replace them with the ones you hold, or set `footer.accreditations` to `""` in every language file.

`[settings] footerDescription` in `config.toml` replaces `footer.description` in every language: use it only on a single-language site.

The address, phone, email, registration number, and hours come from `[organization]` in `config.toml`. See [Organization Info](/givo/customization/organization-info/).

### Copyright
```toml
[settings.copyright]
  enable = true
  text   = "" # `{year}` and `{brand}` are replaced with the build year and `site.title`
```

Leave `text` empty to use `footer.copyright` from the i18n files. `{year}` becomes the year of the build, so the notice stays current, and `{brand}` becomes `[site] title`.

### Footer Links
The link columns come from the `footer` list in `src/config/menu.<language>.json`. The last column (Legal) always goes in the bottom row. The `minimal` footer shows the first two columns, the others show every column. See [Menus](/givo/customization/menus/#footer-menus).

### Ask AI Row
Every footer layout has a row of links that ask an AI assistant about the current page, and links to the page's Markdown copy, `llms.txt`, and `llms-full.txt`. It ships on:

```toml
[settings.pageActions]
  enable    = true
  footer    = true # false removes this row
  providers = ["chatgpt", "claude", "perplexity", "grok"] # empty hides the "Ask" links
```

See [AI Links & llms](/givo/features/ai-links-llms/).

### Theme Credit
Every footer layout ends with the theme credit, and it is also the last line of `llms.txt`. It is editable in `config.toml`. The part of `text` in `[brackets]` becomes the link to `url`:

```toml
[settings.themeCredit]
  enable = true
  text   = "Built on the Givo Astro theme by [Getastrothemes]"
  url    = "https://getastrothemes.com/astro-themes/givo/"
```

### Newsletter
Every footer layout shows a Mailchimp signup form. It posts to `[settings.subscription] formAction` in `config.toml`, which ships as a placeholder: until you set it, `npm run dev` shows a warning inside the form. `[settings.subscription] enable = false` hides every signup form. The heading is `subscription.title` in the i18n files ("Letters from the field: one short update a month on where gifts went"). See [Forms](/givo/customization/forms/).

### Social Links
The social icons in the footers come from `src/config/social.json`:

```json
{
  "main": [
    {
      "enable": true,
      "label": "facebook",
      "icon": "/images/icons/facebook.svg",
      "url": "https://www.facebook.com"
    }
  ]
}
```

The shipped links point to the networks' home pages. Replace each `url` with your own profile, and set `enable` to `false` on networks you don't use. `icon` is an SVG in `src/assets/images/icons/`; `label` is the name screen readers hear. Profile URLs (with a path, such as `https://www.instagram.com/yourcharity`) are also added to your organization's structured data.

### The Closing Band Above The Footer
The closing band is a section with a title, a line of text, and a button, shown after the page content. It is the section `call-to-action.md`, and it is **off by default**: pages that want it turn it on with a `ctaSection` block.

```yaml
# src/content/sections/english/call-to-action.md (trimmed)
enable: false # a page block with `enable: true` shows it
title: "Give an evening a month"
description: "Volunteers run the kitchen, the reading club, and the winter shelter. One evening a month is enough to start, and we train you first."
button:
  enable: true
  label: "Volunteer with us"
  url: "/volunteer/"
  variant: "fill"
secondaryButton: # `volunteer`: the second button (outline)
  enable: false
  label: "Start a fundraiser"
  url: "/fundraise/"
  variant: "outline"
phone: false # `default`: the phone and open-now line from [organization]
image: "/images/photos/volunteer-team-shirts.jpg" # `volunteer` and `default`: the photo beside the copy; empty hides it
imageAlt: "Three volunteers in matching shirts, seen from behind"
note: "One email a month with news from the projects. Unsubscribe in one click." # `newsletter`
donate: # `donate` layout
  cause: "" # cause file name in src/content/causes/; empty = no goal line, plain /donate/ links
  amounts: [] # empty = the cause `impact` amounts, then the first three donate presets
  label: ""
options:
  layout: "default" # default | volunteer | donate | newsletter
```

Turn it on for one page in its frontmatter. The block must include `enable: true`, because the section file ships with `false`:

```yaml
ctaSection:
  enable: true
  title: "Rather give your time?"
  options:
    layout: "volunteer"
```

| Layout       | What it looks like                                                                                   |
| ------------ | ---------------------------------------------------------------------------------------------------- |
| `default`    | The copy and button. With an `image`, beside the photo                                               |
| `volunteer`  | A forest band with a photo and two buttons (`button` and `secondaryButton`)                          |
| `donate`     | A forest band with the live total of the cause in `donate.cause` and quick amount buttons that open `/donate/?cause=<cause>&amount=<n>` |
| `newsletter` | The copy beside the signup form. Shows `default` instead when `[settings.subscription]` is off      |

Most inner pages ship with it on: `donate` on `/home-appeal/` and `/impact/`; `volunteer` on `/home-community/`, `/about/`, and `/team/`; `default` on causes, events, donate, FAQ, testimonials, tribute, volunteer, fundraise, and careers. The main homepage, contact, stories, and partners keep it off.

The title is plain text in one color: Markdown emphasis such as `*word*` shows as plain text.

### Files For Developers
`src/layouts/components/global/Footer.astro` picks the layout and draws `default`. The others are in `src/layouts/components/global/footer/`: `FooterMinimal.astro` and `FooterLarge.astro`, with `FooterColumns.astro` (the link columns), `FooterLegal.astro` (the bottom row), `FooterAi.astro` (the Ask AI row), `FooterCredit.astro` (the theme credit), `FooterSocials.astro`, and `FooterLanguages.astro`. The closing band is `src/layouts/components/sections/CallToAction.astro`, with its layouts in `sections/call-to-action/`.

### Do It With AI
```text
Set the footer to the [default | minimal | large] layout in [settings.layout] of
src/config/config.toml. Rewrite footer.description in each file in src/i18n/ for my
organization: [ONE LINE ABOUT US], translated. Replace footer.accreditations with: [OUR
ACCREDITATIONS, OR "" TO HIDE THE ROW]. Put my social profiles in src/config/social.json:
[URLS], and disable the networks I didn't list.
```

```text
Show the closing band on [PAGE URL] with the [default | volunteer | donate | newsletter]
layout: add a ctaSection block with enable: true and options.layout to the page's content file
in every language folder. Title "[TITLE]", button "[LABEL]" to [URL]. [For donate: set
donate.cause to "[CAUSE ID]".]
```