# Pages

## 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](/givo/customization/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](/givo/customization/causes-campaigns/), [Donation Form](/givo/customization/donation-form/), [Giving Tiers & Receipt](/givo/customization/giving-tiers-receipt/), [Impact & Transparency](/givo/customization/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](/givo/customization/events-calendar/), [Volunteer & Fundraise](/givo/customization/volunteer-fundraise/), [Partners & Gallery](/givo/customization/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](/givo/customization/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](/givo/customization/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](/givo/customization/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](/givo/customization/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:

```yaml
# src/content/causes/english/-index.md
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 | media
```

The four layouts and all fields are in [Section Layouts](/givo/customization/section-layouts/#page-header). 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](/givo/customization/header/) |
| `footerLayout` | `default`, `minimal`, or `large`: another footer on this page. See [Footer](/givo/customization/footer/) |
| `primaryCta` | The main button on this page only (`label`, `url`, `announcement`: `link`, `hide`, or `keep`) |
| Named blocks | `pageHeader`, `ctaSection`, `questionsSection`, … See [Sections](/givo/customization/sections/#blocks-each-page-reads) |

### Add A Page
<Tabs>
  <TabItem label="A text page (no code)">

    For policies, guides, or any page of text. Givo renders every file in `src/content/pages/` as a page.

    <Steps>

    1. Copy `src/content/pages/english/safeguarding-policy.md` to a new file, for example `src/content/pages/english/complaints-policy.md`. The file name becomes the URL: `/complaints-policy/`.

    2. Change `title`, `description`, `date`, and the Markdown body. The `contentPage` block adds an optional `notice` above the text and a `summary` box of key facts beside it; delete what you don't need.

    3. Create the other language versions, in `src/content/pages/french/` and `src/content/pages/arabic/`, with the **same file name**.

    4. Add a link to it in each `src/config/menu.<language>.json`, for example in the footer's **Legal** column.

    </Steps>

  </TabItem>
  <TabItem label="A page made of sections (light code)">

    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.

    <Steps>

    1. Copy `src/pages/[...lang]/home-community.astro` to `src/pages/[...lang]/spring-appeal.astro`. The file name becomes the URL: `/spring-appeal/`.

    2. In the new route, change `"home-community"` in `getEntryCTM("homepage", ...)` to `"spring-appeal"`. List the blocks you use in `const { ... } = 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.

    3. Create `src/content/homepage/english/spring-appeal.md` with a `title`, a `metaDescription`, and one named block per section, each with `enable: true`. Copy blocks from the other homepage files.

    4. Create the other language files, in `src/content/homepage/french/` and `arabic/`, add the page to the menus, and run `npm run astro-check`.

    </Steps>

    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.

  </TabItem>
</Tabs>

### Remove A Page
1. Delete its route file in `src/pages/[...lang]/` and its content (file or folder) in `src/content/`, in every language.
2. Remove its links from each `src/config/menu.<language>.json` and any content file or button that links to it (search the project for the URL, for example `/tribute/`).
3. Run `npm run astro-check`, then `npm 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.

<Aside type="caution">
  Pages link to each other in their content: for example the donate page and the
  gift split on the homepage link to `/impact/`, and many buttons go to
  `/donate/` or `/volunteer/`. Search the project for the URL before you delete
  a page.
</Aside>

### Do It With AI
```text
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 in
src/content/ (every language), remove every link to it from each src/config/menu.<language>.json
and from content files, then run npm run astro-check and npm run build and fix anything
that still points to it.
```