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

Section Layouts

Skill level: Beginner · Time: 1 minute per section

Many Givo sections can be drawn in more than one way. 15 sections, plus the page header, have 2 to 4 layouts each: 44 in all. You pick one with a single line, and the section keeps its copy:

options:
layout: "overlay"

No code changes: every layout of a section reads the same fields. A few layouts use an extra optional field (a photo, a cause id, a caption), shown as a comment in the section file or in the page file that uses it.

Where To Set A Layout

Set it in…It applies to…
The section file, src/content/sections/<language>/<section>.mdEvery page that shows the section without its own layout
A page block, for example reviewsSection: in a page fileThat page only

Set it in every language folder. Without a layout value, a section uses the first value of its list in src/sections.schema.ts (for example photo for the hero, grid for the causes).

Copy the value from the comment next to layout: or from the catalog below. Section files have no schema, so npm run astro-check doesn’t report a misspelled value there: open the page to check it. In page blocks of files with a schema (for example src/content/homepage/english/home-appeal.md), astro-check reports a value that doesn’t exist.

Preview Every Layout: /elements/

The Givo layout gallery at /elements/ with the list of sections and their layouts

Run npm run dev and open http://localhost:4321/elements/. The page shows every section that has more than one layout, in each of its layouts, with the section’s default content, so you can compare looks before you choose. A list at the top jumps to each section, and each preview names the value to copy (options.layout). The page ends with the site header and footer layouts, each with a link to a page that uses it.

The gallery’s copy is in src/content/pages/english/elements.md (and each other language folder). The page is noindex, nofollow and left out of the sitemap. Before launch, keep it as a private reference or delete src/pages/[...lang]/elements.astro, the elements.md files, and the Elements link in the Pages menu of each src/config/menu.<language>.json.

Layout Catalog

The values come from the layoutOption([...]) lists in src/sections.schema.ts. The first value of each list is the one used when layout is empty. The page in brackets shows the layout in use.

Hero

File: hero-section.md · Block: heroSection

LayoutWhat it looks like
photoThe copy and a small donation widget beside one large photo (/)
appealA forest block with the live total of one cause and quick amount chips, beside a large photo (/home-appeal/)
communityTwo path buttons and a rectangle photo, then the office hours, the next event, and how to find you (/home-community/)

donate sets the widget of photo (its cause is passed on to the donate page). appeal reads one cause: appeal.cause is a file name in src/content/causes/, and its goal, amount raised, and newest update fill the panel. community reads the next event from src/content/events/ and the hours from [organization] in config.toml; its optional community fields are listed as a comment in the section file.

Impact Numbers

File: metrics-section.md · Block: metricsSection

LayoutWhat it looks like
reportA forest band with the numbers in one row and a source line
bandA forest band with the intro beside the numbers
plainThe band structure on the page background. Use it on a page that already has a forest band
cardsSolid stat cards in green, forest, gold, and a light tint (/, /home-community/, /about/)

Every number in the sample is a sample. Replace each one with your own.

Feature Grid

File: feature-grid-section.md · Blocks: featureGridSection, and involvedSection for the second grid on /

LayoutWhat it looks like
focusPhoto tiles (/)
scheduleRuled rows with hours and place per item (/home-community/, /fundraise/)
benefitsThe intro and a captioned image beside ruled rows (/volunteer/)

Causes

File: causes-section.md · Block: causesSection

LayoutWhat it looks like
gridCause cards. With options.featured: true, the first featured cause is large and the next ones sit beside it (/)
featuredOne large featured card above a grid of the other causes (/causes/)
listRuled rows, one per cause

options.filter: true adds category chips above the cards (/causes/ turns it on). The goal, amount raised, donors, and days left come from each cause file. See Causes & Campaigns.

Supporter Voices

File: reviews-section.md · Block: reviewsSection

LayoutWhat it looks like
storyOne quote beside a large photo on a full-width band (/)
defaultThree quote cards in a row, featured first (/home-community/)
wallA band of featured quotes, then a wall of quotes with role filter chips (/testimonials/)
overlayThe first quote as a white card on a large photo, with the title above (/home-appeal/)

story and overlay use image, imageAlt, and imageCaption. wall uses featured and chips. The quotes come from src/content/reviews/.

Where The Money Goes

File: gift-split-section.md · Block: giftSplitSection

LayoutWhat it looks like
splitThe intro beside ruled rows, each with a share bar
barThe intro and links beside one stacked bar with a legend (/, /home-appeal/)

Keep the percents adding up to 100, and equal to spend on the impact page. See Impact & Transparency.

Latest Stories

File: related-posts-section.md · Block: relatedPostsSection

LayoutWhat it looks like
defaultDated cards: date, category, and reading time (/blog/)
newsThe newest story large, beside dated rows (/)

Upcoming Events

File: events-section.md · Block: eventsSection

LayoutWhat it looks like
listDated rows: a date column, the title, the time and place, and a Register button (/)
agendaEvents grouped by month in compact rows, without photos (/home-community/)

The events come from src/content/events/, and past events leave the list on their own. See Events & Calendar.

Give Now (Donation)

File: donate-section.md · Block: donateSection

LayoutWhat it looks like
defaultThe full donation form, with the impact receipt as the order summary (/donate/, /tribute/)
quickA teaser: the frequency toggle, preset amount chips, the receipt for the chosen amount, and a continue button that opens /donate/

The section file ships with layout: "quick"; /donate/ sets default in its own block. See Donation Form.

Giving Tiers

File: plans-section.md · Block: plansSection

LayoutWhat it looks like
defaultOne card per monthly tier (/donate/)
compactRuled rows in one card (/home-community/)

Without a plans list in the block, the tiers come from tiers in src/content/donate/<language>/-index.md. See Giving Tiers & Receipt.

Steps

File: steps-section.md · Block: stepsSection

LayoutWhat it looks like
defaultA plain numbered list (/volunteer/, /fundraise/, /careers/)
milestonesA dated list, with the year in each step’s meta (/about/)

FAQ

File: questions-section.md · Block: questionsSection

LayoutWhat it looks like
defaultThe intro and a plain help note beside the question rows (most inner pages)
stackedOne ruled band per group of questions
gridThe intro over two columns of question rows (/home-appeal/)

Volunteer Roles

File: volunteer-roles-section.md · Block: volunteerRolesSection

LayoutWhat it looks like
defaultColumns split by rules, the time each role takes first
listRuled rows: the role and skills, where, the time, and an Apply link (/volunteer/, /home-community/)

The Apply link of list ticks the role in the volunteer form (?role=<id>). See Volunteer & Fundraise.

Contact

File: contact-section.md · Block: contactSection

LayoutWhat it looks like
defaultThe form card beside the office rows (/contact/)
walkthroughThe intro and ruled rows beside the form card (/fundraise/)

The address, phone, email, and hours come from [organization] in config.toml. See Organization Info.

Call To Action

File: call-to-action.md · Block: ctaSection

LayoutWhat it looks like
defaultThe copy and a button; with image, beside the photo (/causes/, /donate/, /faq/)
volunteerA forest band with a photo and two buttons (/about/, /team/, /home-community/)
donateA forest band with the live total of one cause (donate.cause) and amount chips (/home-appeal/, /impact/)
newsletterThe copy beside the newsletter signup form, which posts to [settings.subscription]

The call to action is off in the section file (enable: false). A page shows it with enable: true in its own ctaSection block; the main homepage leaves it off.

One Layout Only

These sections have one layout each, so /elements/ doesn’t list them: the appeal brief (split), appeal updates (timeline), partner logos (plain, file clients.md), values (plain), photo strip (strip), fundraisers (grid), toolkit (list), and default for the cause hero, event hero, event listing, story, open roles, team grid, contact options, volunteer form, blog list, newsletter, video, and not found sections.

Inner pages open with a page header, set per page in a pageHeader block of the page file (there is no section file):

src/content/pages/english/volunteer.md
pageHeader:
breadcrumb: true
badge:
label: "Get involved"
icon: "HandHeart"
tone: "green" # green | gold | amber | forest
description: "Six ongoing roles at the community kitchen, ..."
image: "/images/photos/<your-photo>.jpg"
imageAlt: "What the photo shows"
imageCaption: "Place · what is happening · Photo: credit"
options:
layout: "split" # default | intro | split | media
LayoutWhat it looks like
defaultThe title and description. With image, a large rectangle photo under the copy, with its caption (most list pages)
introCompact: the header of the legal pages
splitThe copy beside a 4:3 photo (/volunteer/, /fundraise/, /tribute/)
mediaThe copy, then a large photo with its caption and a side panel beside it (cause and event pages)

The title comes from the page’s title. The other fields are breadcrumb, eyebrow, badge (label, icon, tone; an empty label hides it), overlay (one small white card over the default or split photo), description, primaryButton, secondaryButton, buttons, badges, image, imageAlt, imageCaption, phone, and summary. options.compact: true gives another layout the intro height.

The site header and footer have their own layouts, set in [settings.layout] of config.toml, or per page with headerLayout and footerLayout in the frontmatter:

[settings.layout]
header = "default" # default | centered | utility
footer = "default" # default | minimal | large

See Header and Footer.

What The Homepages Use

The three homepages show most layouts in use. To reuse a look, copy the block (and any extra fields) from that homepage’s file in src/content/homepage/english/.

Section//home-appeal//home-community/
Herophotoappealcommunity
Impact numberscards–cards
Feature gridfocus (twice)–schedule
Causesgrid (featured)––
Supporter voicesstoryoverlaydefault
Where the money goesbarbar–
Latest storiesnews––
Eventslist–agenda
Volunteer roles––list
Giving tiers––compact
FAQ–grid–
Call to actionoffdonatevolunteer
Otherpartner logosappeal brief, appeal updates, partner logosphoto strip, newsletter

Do It With AI

Switch the [SECTION] section to the [LAYOUT] layout [everywhere | only on PAGE URL]. Check the
allowed values in layoutOption([...]) in src/sections.schema.ts and the comment next to layout: in
src/content/sections/english/[FILE].md. If the layout uses extra fields, copy them from the
page file that already uses it. Change every language folder, then run npm run astro-check and
tell me which page to open to check it.
Type something to search...