Pages
Skill level: Beginner to edit, light code to add a page made of sections
Every page has two parts: a route file in src/pages/[...lang]/, which decides which sections the page shows and in what order, and a content file in src/content/, which holds its title, SEO fields, page header, and named blocks. You edit the content file; you only touch the route to add, remove, or reorder sections.
Every Page And Its File
Paths are for English. The other languages use the same files in french/ and arabic/, served under /fr/ and /ar/ (for example /fr/donate/).
Homepages
| Page | URL | Route (src/pages/[...lang]/) | Content (src/content/) |
|---|---|---|---|
| Multi-cause charity (main homepage) | / | index.astro | homepage/english/-index.md |
| Single emergency appeal | /home-appeal/ | home-appeal.astro | homepage/english/home-appeal.md |
| Local community non-profit | /home-community/ | home-community.astro | homepage/english/home-community.md |
The two extra homepages are examples: they ship with robots: "noindex, follow" and excludeFromSitemap: true. See Homepages to pick one as your home.
Causes And Giving
| Page | URL | Route | Content |
|---|---|---|---|
| Causes | /causes/ | causes/index.astro | causes/english/-index.md |
| Cause page | /causes/<file>/ | causes/[single].astro | causes/english/<file>.md |
| Donate | /donate/ | donate.astro | donate/english/-index.md and sections/english/donate-section.md |
| Thank-you page | /donate/thanks/ | donate/thanks.astro | pages/english/donate-thanks.md |
| Tribute gifts | /tribute/ | tribute.astro | pages/english/tribute.md |
| Impact and transparency | /impact/ | impact.astro | impact/english/-index.md |
Guides: Causes & Campaigns, Donation Form, Giving Tiers & Receipt, Impact & Transparency.
Get Involved
| Page | URL | Route | Content |
|---|---|---|---|
| Events | /events/ | events/index.astro | events/english/-index.md |
| Event page | /events/<file>/ | events/[single].astro | events/english/<file>.md |
| Add to calendar file | /events/<file>.ics | events/[single].ics.ts | built from the event |
| Volunteer | /volunteer/ | volunteer.astro | pages/english/volunteer.md and sections/english/volunteer-section.md |
| Fundraise for us | /fundraise/ | fundraise.astro | pages/english/fundraise.md |
| Corporate partnerships | /partners/ | partners.astro | pages/english/partners.md |
| Gallery | /gallery/ | gallery.astro | gallery/english/-index.md |
Guides: Events & Calendar, Volunteer & Fundraise, Partners & Gallery.
About, Stories, And Help
| Page | URL | Route | Content |
|---|---|---|---|
| About | /about/ | about.astro | about-us/english/-index.md |
| Team | /team/ | team/index.astro | team/english/-index.md and one file per member |
| Supporter voices | /testimonials/ | testimonials.astro | pages/english/testimonials.md, quotes from reviews/english/ |
| Careers | /careers/ | careers/index.astro | careers/english/-index.md |
| Job page | /careers/<file>/ | careers/[single].astro | careers/english/<file>.md |
| Stories | /blog/, and /blog/page/<n>/ once there are more stories than blogPagination | blog/index.astro, blog/page/[slug].astro | blog/english/-index.md |
| Story | /blog/<file>/ | blog/[single].astro | blog/english/<file>.mdx |
| Category and tag lists | /blog/category/<name>/, /blog/tag/<name>/ | blog/category/, blog/tag/ | built from the stories’ categories and tags |
| RSS feed | /blog/rss.xml | blog/rss.xml.ts | built from the stories |
| FAQ | /faq/ | faq.astro | faq/english/-index.md |
| Contact | /contact/ | contact.astro | contact/english/-index.md and sections/english/contact-section.md |
The stories live in the blog folder and keep the /blog/ URL; the menus call them Stories. See Stories.
Text Pages, Tools, And Files
| Page | URL | Route | Content |
|---|---|---|---|
| Privacy policy, terms, cookie policy, donation and refund policy, safeguarding policy | /privacy-policy/, /terms-conditions/, /cookie-policy/, /donation-policy/, /safeguarding-policy/ | [page].astro | pages/english/<file>.md |
| Shortcode examples | /components/ | [page].astro | pages/english/components.mdx |
| Layout gallery | /elements/ | elements.astro | pages/english/elements.md |
| 404 | any missing URL | 404.astro (and src/pages/404.astro) | sections/english/not-found-section.md |
| AI and search files | /llms.txt, /llms-full.txt, /robots.txt, <page>.md | llms.txt.ts, llms-full.txt.ts, src/pages/robots.txt.ts, src/pages/[...path].md.ts | built from your content and config.toml. See SEO & AI Visibility |
Every file in src/content/pages/ becomes a page at /<file name>/ through [page].astro, except elements, volunteer, donate-thanks, testimonials, tribute, fundraise, and partners, which have their own routes.
Each collection (causes, events, reviews, careers, team, stories, and the rest) is explained in Collections.
Sample Pages To Replace Or Remove
Givo ships with a full sample charity. Every goal, amount, quote, name, and figure in it is a sample. Before launch:
| Replace with your own | Where |
|---|---|
| The 9 sample causes, with their goals, amounts raised, donors, deadlines, and updates | src/content/causes/, and the Causes menu in each src/config/menu.<language>.json |
| The currency, preset amounts, monthly tiers, and impact map | src/content/donate/ |
| The 7 sample events and their dates | src/content/events/ |
| The spending split, results, reports, and facts | src/content/impact/, and the gift split on the homepages |
| The 11 sample supporter quotes | src/content/reviews/ |
| The 8 team members, 3 job openings, 6 stories, and 3 authors | team/, careers/, blog/, author/ |
| The partner names, sponsorship levels, and gallery photos | pages/english/partners.md, gallery/english/-index.md |
| The placeholder legal texts | privacy-policy.md, terms-conditions.md, cookie-policy.md, donation-policy.md, safeguarding-policy.md in src/content/pages/ |
| Remove if you don’t need it | Files |
|---|---|
| The two extra homepages | home-appeal.astro, home-community.astro and their files in src/content/homepage/ |
The shortcode examples /components/ | src/content/pages/english/components.mdx (and each other language folder) |
The layout gallery /elements/ | src/pages/[...lang]/elements.astro and pages/english/elements.md (and each other language folder) |
| Tribute, partners, gallery, careers | Their route files and content files |
Sample facts are marked # sample in the content files: search the project for # sample to find them all, and see IMAGE-CREDITS.md for every sample photo. The job openings feed JobPosting data for search engines: keep only real, open roles.
The Pages menu in the header (in each src/config/menu.<language>.json) lists every page of the theme. Remove it, or set its "enable" to false in every file, before launch. See Menus.
Page Header
Most inner pages open with a page header. Its title is the page’s title; everything else is in a pageHeader block of the page file:
title: "Current appeals"pageHeader: breadcrumb: true badge: label: "Current appeals" icon: "Sprout" tone: "green" # green | gold | amber | forest description: "Every open appeal, with its goal, what has been raised so far, and what a gift pays for." summary: false options: layout: "default" # default | intro | split | mediaThe four layouts and all fields are in Section Layouts. The legal pages use intro. Cause and event pages build their header from the cause or event file, in the media layout. The homepages open with their hero section instead.
Some pages also have a jumpNav list (label and anchor) for the “On this page” links in the header, as on /donate/ and /team/. Each anchor is the id of a section further down the page.
Fields Every Page Accepts
These frontmatter fields work on page and entry files. src/content/_file_format.md explains most of them; the full list is the page schema in src/content.config.ts.
| Field | What it does |
|---|---|
title, description | The page title and summary |
metaTitle, metaDescription | Replace the title and description in search results only |
image, imageDark | Social preview image for this page (and the photo on cards, for entries); imageDark is an optional dark mode version |
draft | true leaves the page out of the built site (it still shows in npm run dev) |
customSlug | A different URL segment than the file name. Use the same value in every language |
canonical, robots, keywords | SEO overrides |
excludeFromSitemap, excludeFromAi | Leave the page out of the sitemap, or out of llms.txt and the Markdown copies |
excludeFromCollection | Keep an entry’s page but leave it out of lists |
disableTagline | Don’t add the site tagline to this page’s title |
date, updated | Publish date and last meaningful edit, used in structured data and the sitemap (on the legal pages, date is the “Last updated” line) |
headerLayout | default, centered, or utility: another header on this page. See Header |
footerLayout | default, minimal, or large: another footer on this page. See Footer |
primaryCta | The main button on this page only (label, url, announcement: link, hide, or keep) |
| Named blocks | pageHeader, ctaSection, questionsSection, … See Sections |
Add A Page
For policies, guides, or any page of text. Givo renders every file in src/content/pages/ as a page.
-
Copy
src/content/pages/english/safeguarding-policy.mdto a new file, for examplesrc/content/pages/english/complaints-policy.md. The file name becomes the URL:/complaints-policy/. -
Change
title,description,date, and the Markdown body. ThecontentPageblock adds an optionalnoticeabove the text and asummarybox of key facts beside it; delete what you don’t need. -
Create the other language versions, in
src/content/pages/french/andsrc/content/pages/arabic/, with the same file name. -
Add a link to it in each
src/config/menu.<language>.json, for example in the footer’s Legal column.
For landing pages that reuse Givo’s sections. The extra homepages are the model: their route reads one file from the homepage collection and renders its sections in order.
-
Copy
src/pages/[...lang]/home-community.astrotosrc/pages/[...lang]/spring-appeal.astro. The file name becomes the URL:/spring-appeal/. -
In the new route, change
"home-community"ingetEntryCTM("homepage", ...)to"spring-appeal". List the blocks you use inconst { ... } = entry?.data, and edit the section lines inside<Base>to the sections you want, top to bottom. A section you add needs its import at the top of the file, like the ones already there. Keep<LayoutVariants section="..." content={...} />for the sections that already use it. -
Create
src/content/homepage/english/spring-appeal.mdwith atitle, ametaDescription, and one named block per section, each withenable: true. Copy blocks from the other homepage files. -
Create the other language files, in
src/content/homepage/french/andarabic/, add the page to the menus, and runnpm run astro-check.
Don’t build a section page from a file in src/content/pages/: every file there is also built as a text page at the same URL.
Remove A Page
- Delete its route file in
src/pages/[...lang]/and its content (file or folder) insrc/content/, in every language. - Remove its links from each
src/config/menu.<language>.jsonand any content file or button that links to it (search the project for the URL, for example/tribute/). - Run
npm run astro-check, thennpm run build, to make sure nothing still points to it.
To hide a text page or an entry without deleting it, set draft: true in its content file.
Do It With AI
Remove the pages I don't need from my Givo site: [LIST, e.g. /partners/, /careers/,/home-community/]. For each one, delete its route in src/pages/[...lang]/ and its content insrc/content/ (every language), remove every link to it from each src/config/menu.<language>.jsonand from content files, then run npm run astro-check and npm run build and fix anythingthat still points to it.