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

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]

KeyShips asWhat 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
trailingSlashtrueURLs 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.

KeyShips asWhat 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
taxNotetrueShows “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
closedDatestwo sample datesDays the office is closed (YYYY-MM-DD)
[organization.address]sample addressshow, street, locality, region, postalCode, country. show = false hides the street and postal code everywhere
[organization.geo]emptyOptional latitude and longitude, used only with type = "LocalBusiness"
[organization.hours]sample hoursmon 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]

KeyShips asWhat it does
author""Default author meta tag. Empty uses the organization name
keywordseight sample phrasesDefault 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] enabletrueStructured 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] faqPagetrueFAQ markup on /faq/
[seo.robotsTxt] enabletrueBuilds /robots.txt
[seo.robotsTxt] disallow[]Paths crawlers must skip
[seo.robotsTxt] aiSearchtruefalse asks AI answer engines (ChatGPT search, Claude, Perplexity, and others) not to fetch your pages
[seo.robotsTxt] aiTrainingtruefalse asks crawlers that collect content to train AI models to stay away
[seo.robotsTxt] contentSignalsfalsetrue adds a Content-Signal line with the two choices above
[seo.ai] llmsTxttrueBuilds /llms.txt and /llms-full.txt per language, with your organization facts first
[seo.ai] markdownPagestrueA 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] enabletrueBuilds /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]

KeyShips asWhat 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
blogPagination6Stories per list page
pagination8Items 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
stickyHeadertrueKeeps 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.

Table: [settings.layout]

KeyShips asValues
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.

KeyShips asWhat it does
enabletruefalse gives you the browser’s normal scrolling
respectReducedMotiontrueKeeps it off for visitors who ask for less motion
duration1.1How long the glide lasts. Higher feels slower
easing"expo"expo, linear, easeOutQuad, or easeOutCubic
smoothWheeltrueSmooths mouse wheel and trackpad scrolling
syncTouchfalseSmooths touch input on devices with a mouse and a touchscreen
wheelMultiplier1How far one wheel movement scrolls
touchMultiplier1How far one swipe scrolls when syncTouch is on
anchorstrueGlides to #section links on the same page
autoRaftrueLets Lenis run its own animation loop. Leave it on
stopInertiaOnNavigatetrueStops any remaining glide when a visitor clicks a link

Light And Dark Mode

Table: [settings.colorScheme]

KeyShips asWhat it does
default"light"system (follows the visitor’s device), light, or dark, until a visitor picks one
switchertrueShows the light/dark button in the header, the mobile menu, and the footer

Details: Colors & Fonts.

Table: [settings.cookieConsent]

KeyShips asWhat it does
enabletrueShows the cookie banner and holds data-consent scripts until visitors choose
revision1Raise 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.

Table: [settings.pageActions]

KeyShips asWhat it does
enabletruefalse turns off the AI links row
footertrueA 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.

KeyShips asWhat it does
enabletrueTurns the reveal animations on or off
respectReducedMotiontrueShows 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.14How 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.

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.

KeyShips asWhat it does
enabletruefalse 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
formActiona placeholder URLPlaceholder. 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]

KeyShips asWhat it does
enabletruefalse 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"]
showDefaultLangInUrlfalsetrue 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.

KeyShips asWhat it does
enabletrueShows 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.

KeyShips asWhat it does
enabletrueShows the bar
hideOn["/donate/"]Path prefixes where the bar is left out (without the language prefix). /donate/ also covers /donate/thanks/
hideNearFootertrueThe 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.

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]

KeyShips asWhat 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
generateImagestrueDuring 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/

FileWhat it holdsPage
menu.<language>.jsonThe header menu (headerPrimary) and the footer link columns (footer)Menus
language.jsonThe languages: name, code, content folder, direction, ogLocale, dateLocale, and orderInternationalization
fonts.jsonThe fonts: body and headings, Arabic, and codeColors & Fonts
social.jsonSocial 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.
Type something to search...