# Config Reference (config.toml)

## Config Reference

**File:** `src/config/config.toml` · **Skill level:** Beginner

`config.toml` holds every site-wide setting: your organization's details, the header and footer layouts, the forms, the background patterns, SEO, and more. It is grouped into tables: a line in `[brackets]` starts a table, and every `key = value` line below it belongs to that table until the next one. Most keys have a comment beside them. This page explains them all in one place, with the value Givo ships.

Values marked `# sample` or `PLACEHOLDER` in the file must be replaced before you launch.

Giving settings are not in this file: the currency, the amounts, the monthly tiers, and the donation form connection live in `src/content/donate/<language>/-index.md`. See [Donation Form](/givo/customization/donation-form/).

<Aside type="note">
  `npm run dev` picks up a saved change to `config.toml` and reloads the page.
  Restart it after you change `trailingSlash`, anything in
  `[settings.multilingual]`, or `src/config/fonts.json`: those are read only
  when the server starts.
</Aside>

### Site Identity
Table: `[site]`

| Key                | Ships as                 | What it does                                                                                   |
| ------------------ | ------------------------ | ---------------------------------------------------------------------------------------------- |
| `title`            | `"Givo"`                 | Organization name. The home page title, `{brand}` in the footer copyright, structured data, and social cards. Also the organization name while `[organization] name` is empty |
| `description`      | `""`                     | Default description for search results and social previews. Empty uses `seo.siteDescription` in each `src/i18n/<language>.json`. A value here is used for every language |
| `tagline`          | `""`                     | Added to every page title ("Events - your tagline") and to social titles. Empty uses `seo.tagline` in each `src/i18n/<language>.json`. A value here is used for every language. A page drops it with `disableTagline: true` |
| `taglineSeparator` | `""`                     | Text between the page title and the tagline. Empty uses `" - "`                                |
| `baseUrl`          | `"https://example.com"`  | **Placeholder.** Your live address. Canonical links, the sitemap, `robots.txt`, RSS feeds, `llms.txt`, and social URLs are built from it, and `npm run build` warns while it is `example.com`. A `SITE_URL` environment variable on the build overrides it |
| `logo`             | `""`                     | Path to a logo image that replaces the built-in wordmark (SVG or PNG). Empty draws the wordmark |
| `logoText`         | `"Givo"`                 | The wordmark text, shown exactly as typed. Its first "i" gets a heart as its dot; text without an "i" gets the heart in front |
| `logoWidth`, `logoHeight` | `"28px"`          | Logo image size. Used only when `logo` is set                                                  |
| `trailingSlash`    | `true`                   | URLs end with `/` (`/causes/`). Restart the dev server after a change                          |
| `[site.favicon] path`  | `"/images/favicons"` | Where the generated favicons go. Leave it as it is                                             |
| `[site.favicon] image` | `"/images/favicon.svg"` | Source image for `npm run generate-favicons` (`src/assets/images/favicon.svg`)              |

Details: [Site Identity & Logo](/givo/customization/site-identity-logo/).

### Organization Details
Tables: `[organization]`, `[organization.address]`, `[organization.geo]`, `[organization.hours]`

One source for your organization's name, registration number, phone, email, address, and office hours. The header, the footers, the contact page, the donation form's fine print, the forms, the event pages, the structured data, and `llms.txt` all read them from here.

| Key                  | Ships as                    | What it does                                                         |
| -------------------- | --------------------------- | -------------------------------------------------------------------- |
| `name`               | `""`                        | Public name. Empty uses `site.title`                                 |
| `legalName`          | `""`                        | Registered legal name, if it differs. Structured data and the footer line |
| `registrationNumber` | `"12-3456789"` (sample)     | Charity or non-profit registration number. Shown in the footers and the donation fine print, and as `taxID` in structured data. Empty hides it |
| `type`               | `"NGO"`                     | schema.org type: `NGO`, `Organization`, or `LocalBusiness`           |
| `nonprofitStatus`    | `"Nonprofit501c3"` (sample) | Optional schema.org non-profit type. Empty leaves it out             |
| `foundingYear`       | `"2009"` (sample)           | Year founded, as `foundingDate` in structured data                   |
| `taxNote`            | `true`                      | Shows "Gifts are tax-deductible where the law allows" with the donation fine print and in `llms.txt` |
| `sameAs`             | `[]`                        | Extra profile URLs for structured data only (a charity register listing, Wikipedia) |
| `phone`              | `"+15550100199"` (sample)   | Phone for call links, in E.164 format. Empty hides every call link   |
| `phoneDisplay`       | `"(555) 010-0199"` (sample) | How the phone is written on the page                                 |
| `sms`, `smsDisplay`  | `""`                        | Optional number for "Text" links on the contact page. Empty hides them |
| `email`              | `"hello@example.org"`       | **Placeholder.** Your public email                                   |
| `priceRange`         | `""`                        | Leave empty for a non-profit (`LocalBusiness` only)                  |
| `timezone`           | `"America/New_York"`        | Time zone for office hours, event dates, and form dates              |
| `closedDates`        | two sample dates            | Days the office is closed (`YYYY-MM-DD`)                             |
| `[organization.address]` | sample address          | `show`, `street`, `locality`, `region`, `postalCode`, `country`. `show = false` hides the street and postal code everywhere |
| `[organization.geo]` | empty                       | Optional `latitude` and `longitude`, used only with `type = "LocalBusiness"` |
| `[organization.hours]` | sample hours              | `mon` to `sun`, 24-hour `"HH:MM-HH:MM"`. Empty is closed             |

Every key, its format, and where it appears: [Organization Info](/givo/customization/organization-info/).

### Search Engines
Tables: `[seo]`, `[seo.schema]`, `[seo.robotsTxt]`, `[seo.ai]`, `[seo.sitemap]`

| Key                          | Ships as  | What it does                                                                                 |
| ---------------------------- | --------- | -------------------------------------------------------------------------------------------- |
| `author`                     | `""`      | Default author meta tag. Empty uses the organization name                                    |
| `keywords`                   | eight sample phrases | Default keywords for pages without their own `keywords`. Use your causes and the places you work |
| `robots`                     | `"index, follow, max-snippet:-1, ..."` | Default robots meta tag. Lets search and AI answers quote pages and show images in full |
| `[seo.schema] enable`        | `true`    | Structured data (JSON-LD) on every page: the organization with a donate action, the website, the page, and causes, events, stories, breadcrumbs, and job postings where they apply. `false` removes every block |
| `[seo.schema] faqPage`       | `true`    | FAQ markup on `/faq/`                                                                         |
| `[seo.robotsTxt] enable`     | `true`    | Builds `/robots.txt`                                                                          |
| `[seo.robotsTxt] disallow`   | `[]`      | Paths crawlers must skip                                                                      |
| `[seo.robotsTxt] aiSearch`   | `true`    | `false` asks AI answer engines (ChatGPT search, Claude, Perplexity, and others) not to fetch your pages |
| `[seo.robotsTxt] aiTraining` | `true`    | `false` asks crawlers that collect content to train AI models to stay away                   |
| `[seo.robotsTxt] contentSignals` | `false` | `true` adds a `Content-Signal` line with the two choices above                             |
| `[seo.ai] llmsTxt`           | `true`    | Builds `/llms.txt` and `/llms-full.txt` per language, with your organization facts first     |
| `[seo.ai] markdownPages`     | `true`    | A Markdown copy of each cause, event, story, job, donate, FAQ, and impact page at `<page>.md` |
| `[seo.ai] indexNowKey`       | `""`      | An 8 to 128 character key turns on IndexNow; run `npm run indexnow` after each deploy        |
| `[seo.sitemap] enable`       | `true`    | Builds `/sitemap-index.xml`                                                                   |
| `[seo.sitemap] exclude`      | `["donate/thanks"]` | Folder names to leave out of the sitemap. The thank-you page after a gift ships excluded |

Details: [SEO & AI Visibility](/givo/customization/seo-ai-visibility/).

### General Settings
Table: `[settings]`

| Key                   | Ships as                 | What it does                                                                     |
| --------------------- | ------------------------ | -------------------------------------------------------------------------------- |
| `blogFolder`          | `"blog"`                 | Folder name of the stories (blog). Changing it also means renaming the folders in `src/content/` and `src/pages/[...lang]/` and the collection in `src/content.config.ts`. Most sites keep it |
| `blogPagination`      | `6`                      | Stories per list page                                                            |
| `pagination`          | `8`                      | Items per page on other paginated lists                                          |
| `patterns`            | `"organic"`              | The faint background patterns (hearts, leaf sprigs, a vine, a wave) on heroes, panels, bands, page headers, and footers. `"none"` turns them off |
| `stickyHeader`        | `true`                   | Keeps the header pinned while scrolling (the announcement bar scrolls away)      |
| `contactFormAction`   | `"https://formsubmit.co/your-email@example.com"` | **Placeholder.** Where the contact, volunteer, and fundraise forms send their data. `npm run dev` and `build` warn until you change it |
| `contactFormProvider` | `"formsubmit.co"`        | `"formsubmit.co"`, `"formspree"`, or `"netlify"`                                 |
| `footerDescription`   | `""`                     | Footer description. Empty uses `footer.description` from `src/i18n/<language>.json` |

Details: [Forms](/givo/customization/forms/) and [Colors & Fonts](/givo/customization/colors-fonts/#background-patterns).

### Header And Footer Layouts
Table: `[settings.layout]`

| Key      | Ships as    | Values                              |
| -------- | ----------- | ----------------------------------- |
| `header` | `"default"` | `default`, `centered`, `utility`    |
| `footer` | `"default"` | `default`, `minimal`, `large`       |

A page's `headerLayout` or `footerLayout` frontmatter wins. The emergency appeal homepage uses `centered` and `minimal`, the community homepage `utility` and `large`. See [Header](/givo/customization/header/) and [Footer](/givo/customization/footer/).

### Smooth Scroll
Table: `[settings.smoothScroll]`

Smooth scrolling powered by Lenis. It ships **on**, and turns itself off on touch devices and for visitors who ask for less motion. See [Smooth Scroll](/givo/features/smooth-scroll/).

| Key                     | Ships as | What it does                                                    |
| ----------------------- | -------- | --------------------------------------------------------------- |
| `enable`                | `true`   | `false` gives you the browser's normal scrolling                |
| `respectReducedMotion`  | `true`   | Keeps it off for visitors who ask for less motion               |
| `duration`              | `1.1`    | How long the glide lasts. Higher feels slower                   |
| `easing`                | `"expo"` | `expo`, `linear`, `easeOutQuad`, or `easeOutCubic`              |
| `smoothWheel`           | `true`   | Smooths mouse wheel and trackpad scrolling                      |
| `syncTouch`             | `false`  | Smooths touch input on devices with a mouse and a touchscreen   |
| `wheelMultiplier`       | `1`      | How far one wheel movement scrolls                              |
| `touchMultiplier`       | `1`      | How far one swipe scrolls when `syncTouch` is on                |
| `anchors`               | `true`   | Glides to `#section` links on the same page                     |
| `autoRaf`               | `true`   | Lets Lenis run its own animation loop. Leave it on              |
| `stopInertiaOnNavigate` | `true`   | Stops any remaining glide when a visitor clicks a link          |

### Light And Dark Mode
Table: `[settings.colorScheme]`

| Key        | Ships as   | What it does                                                                  |
| ---------- | ---------- | ----------------------------------------------------------------------------- |
| `default`  | `"light"`  | `system` (follows the visitor's device), `light`, or `dark`, until a visitor picks one |
| `switcher` | `true`     | Shows the light/dark button in the header, the mobile menu, and the footer     |

Details: [Colors & Fonts](/givo/customization/colors-fonts/#dark-mode).

### Cookie Banner
Table: `[settings.cookieConsent]`

| Key        | Ships as | What it does                                                                  |
| ---------- | -------- | ----------------------------------------------------------------------------- |
| `enable`   | `true`   | Shows the cookie banner and holds `data-consent` scripts until visitors choose |
| `revision` | `1`      | Raise it by 1 when your cookie use changes, to ask every visitor again       |

The banner's copy is in `src/content/sections/english/cookie-consent.md` (and each other language folder). If you turn the banner off, also set `enable` to `false` on the "Cookie settings" item in the Legal column of the footer menus. Details: [Cookies & Analytics](/givo/customization/cookies-analytics/).

### AI Links
Table: `[settings.pageActions]`

| Key         | Ships as | What it does                                                                                  |
| ----------- | -------- | --------------------------------------------------------------------------------------------- |
| `enable`    | `true`   | `false` turns off the AI links row                                                            |
| `footer`    | `true`   | A row in every footer layout with "Ask" links for the current page, its Markdown copy, `llms.txt`, and `llms-full.txt`. The Markdown links need `[seo.ai] markdownPages` |
| `providers` | `["chatgpt", "claude", "perplexity", "grok"]` | Assistants offered in "Ask". Any of these four. Empty hides the "Ask" links |

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

### Theme Credit
Table: `[settings.themeCredit]`

The theme credit in every footer layout and at the end of `llms.txt`. The part of `text` in `[brackets]` becomes the link to `url`. It is the same English sentence in every language.

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

### Animations
Table: `[settings.animation]`

Content fades in with a small rise as it scrolls into view, once.

| Key                    | Ships as                | What it does                                       |
| ---------------------- | ----------------------- | -------------------------------------------------- |
| `enable`               | `true`                  | Turns the reveal animations on or off              |
| `respectReducedMotion` | `true`                  | Shows content without animation for visitors who ask for less motion |
| `easing`               | `"cubic-bezier(0.215, 0.61, 0.355, 1)"` | The animation curve                |
| `duration`             | `"700ms"`               | Reveal duration                                    |
| `distance`             | `"1.25rem"`             | How far content rises while fading in              |
| `rootMargin`, `threshold` | `"0px 0px -8% 0px"`, `0.14` | How early an element starts animating     |

Details: [Animations](/givo/customization/animations/).

### Layout Switcher (Demo Only)
Table: `[settings.layoutSwitcher]`

`enable = true` adds a floating **Change layout** button that previews every layout of the section in view. It is for the theme's demo site. Keep `enable = false` on your own site: the pages then render only the layouts chosen in your content files. To change how a section looks, set `options.layout`: see [Section Layouts](/givo/customization/section-layouts/).

### Copyright
Table: `[settings.copyright]`

`enable` (`true`) shows the copyright line in the footer. `text` (`""`) overrides `footer.copyright` from `src/i18n/<language>.json` for every language. In both, `{year}` becomes the year of the build and `{brand}` the `site.title`.

### Newsletter
Table: `[settings.subscription]`

The Mailchimp signup used by the newsletter section, the `large` footer, and the call-to-action `newsletter` layout.

| Key                 | Ships as          | What it does                                                                   |
| ------------------- | ----------------- | ------------------------------------------------------------------------------ |
| `enable`            | `true`            | `false` hides every signup form and the newsletter section. The call-to-action `newsletter` layout then shows as `default` |
| `title`             | `""`              | Empty uses `subscription.title` from `src/i18n/<language>.json`                |
| `note`              | `""`              | The consent line under the field. Empty uses `subscription.note`               |
| `formAction`        | a placeholder URL | **Placeholder.** Your Mailchimp embedded form action. Change each `&amp;` in the copied URL to `&`. `npm run dev` shows a warning inside each form until it is set |
| `mailchimpTagValue` | `""`              | Optional Mailchimp tag id added to every signup                                |

### Languages
Table: `[settings.multilingual]`

| Key                    | Ships as | What it does                                                          |
| ---------------------- | -------- | --------------------------------------------------------------------- |
| `enable`               | `true`   | `false` builds only the default language. Then run `npm run remove-multilingual` to delete the files of every other language |
| `defaultLanguage`      | `"en"`   | Language served without a prefix                                     |
| `disableLanguages`     | `[""]`   | Languages to skip, for example `["fr"]`                              |
| `showDefaultLangInUrl` | `false`  | `true` adds the prefix to the default language too (`/en/causes/`)   |

Restart the dev server after any change here. Details: [Internationalization](/givo/customization/internationalization/).

### Header Button
Table: `[settings.navigationButton]`

The **Donate** button at the end of the header, a pill with a small heart. The mobile donate bar uses the same button.

| Key      | Ships as     | What it does                                                                 |
| -------- | ------------ | ---------------------------------------------------------------------------- |
| `enable` | `true`       | Shows the button                                                             |
| `label`  | `""`         | Empty uses `navigation.buttonLabel` from `src/i18n/<language>.json` ("Donate"). A value here is used in every language |
| `url`    | `"/donate/"` | Where it goes. The button is hidden on that page itself                      |

### Mobile Donate Bar
Table: `[settings.mobileActionBar]`

A bar fixed to the bottom of the screen on phones (below 768 px), with a short line (`mobileBar.line` in `src/i18n/<language>.json`) and the header's **Donate** button.

| Key              | Ships as         | What it does                                                    |
| ---------------- | ---------------- | --------------------------------------------------------------- |
| `enable`         | `true`           | Shows the bar                                                   |
| `hideOn`         | `["/donate/"]`   | Path prefixes where the bar is left out (without the language prefix). `/donate/` also covers `/donate/thanks/` |
| `hideNearFooter` | `true`           | The bar slides away while the footer is visible                 |

It also slides away while a form field has focus and while the menu or a dialog is open. Details: [Header](/givo/customization/header/#the-mobile-donate-bar).

### Secondary Header Link
Table: `[settings.navigationSecondaryLink]`

A text link before the header button, in the `default` and `centered` header layouts. It ships off (`enable = false`). `label` (`""`) uses `navigation.secondaryLabel` ("Contact"); `url` is `"/contact/"`.

### Code Blocks And Tables Of Contents
Tables: `[settings.markup.codeBlocks]`, `[settings.markup.tableOfContents]`

- `[settings.markup.codeBlocks] theme`: `auto` (follows light and dark mode, the default) or `dark` (a dark code window in both modes), for fenced code in Markdown.
- `[settings.markup.tableOfContents]`: the "On this page" list on stories and text pages such as the privacy policy. It ships with `enable = true`, `startLevel = 1`, `endLevel = 5`, `ordered = false`, and `expanded = false`.

### Social Previews
Table: `[opengraph]`

| Key              | Ships as                    | What it does                                                         |
| ---------------- | --------------------------- | -------------------------------------------------------------------- |
| `image`          | `"/images/og-image.jpg"`    | Shared preview image (`public/images/og-image.jpg`), used when a page has no `image` and no generated card |
| `generateImages` | `true`                      | During `npm run build`, renders a 1200×630 card (logo, section, title, description) for every page without an `image` |
| `theme`          | `"light"`                   | `light` or `dark` palette for the generated cards and `npm run generate-og-image` |
| `ogLocale`       | `"en_US"`                   | Fallback locale. Each language sets its own `ogLocale` in `src/config/language.json` |
| `ogType`         | `"website"`                 | Open Graph type                                                      |
| `twitter`, `twitterCard` | `""`, `"summary_large_image"` | X (Twitter) handle and card type                             |

Details: [Site Identity & Logo](/givo/customization/site-identity-logo/#social-preview-images).

### Custom Head Scripts
Table: `[head]`

`content` is pasted into the `<head>` of every page. Use it for analytics, verification tags, or extra stylesheets. With the cookie banner on, change each tracking `<script>` to `<script type="text/plain" data-consent="analytics">` (or `"marketing"`) so it waits for consent; the comment above `[head]` shows an example. See [Cookies & Analytics](/givo/customization/cookies-analytics/).

### The Other Files In `src/config/`
| File                              | What it holds                                                                        | Page                                                        |
| --------------------------------- | ------------------------------------------------------------------------------------ | ----------------------------------------------------------- |
| `menu.<language>.json`            | The header menu (`headerPrimary`) and the footer link columns (`footer`)             | [Menus](/givo/customization/menus/)                         |
| `language.json`                   | The languages: name, code, content folder, direction, `ogLocale`, `dateLocale`, and order | [Internationalization](/givo/customization/internationalization/) |
| `fonts.json`                      | The fonts: body and headings, Arabic, and code                                       | [Colors & Fonts](/givo/customization/colors-fonts/#fonts)   |
| `social.json`                     | Social links and their icons (`main` list)                                           | [Footer](/givo/customization/footer/#social-links)          |

Colors are not in `src/config/`: they are tokens in `src/styles/theme.css`.

### Do It With AI
```text
Explain each table of src/config/config.toml in one line, then list every value marked
"# sample" or "PLACEHOLDER" that I must replace before launch, and the current value of each.
Also list the placeholders in src/content/donate/english/-index.md. Don't change anything yet.
```