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.
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.
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 | "[email protected]" | 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.
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.
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/[email protected]" | 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 and Colors & Fonts.
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 and 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.
| 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.
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.
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.
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.
[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.
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.
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 & 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.
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.
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) ordark(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 withenable = true,startLevel = 1,endLevel = 5,ordered = false, andexpanded = 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.
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.
The Other Files Insrc/config/
| File | What it holds | Page |
|---|---|---|
menu.<language>.json | The header menu (headerPrimary) and the footer link columns (footer) | Menus |
language.json | The languages: name, code, content folder, direction, ogLocale, dateLocale, and order | Internationalization |
fonts.json | The fonts: body and headings, Arabic, and code | Colors & Fonts |
social.json | Social links and their icons (main list) | Footer |
Colors are not in src/config/: they are tokens in src/styles/theme.css.
Do It With AI
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.