← Back to site

Managing Sponsors

Sponsors are stored in src/content/sponsors/ and organized into tier subfolders.

Tier Structure

The sponsor’s tier is determined by which folder the file is in — not by a frontmatter field. To change a sponsor’s tier, move the file to a different folder.

src/content/sponsors/
├── diamond/
├── platinum/
├── gold/
├── silver/
└── bronze/

Creating a Sponsor

Create a new file inside the appropriate tier folder. The filename is just an identifier — display order comes from the order frontmatter field.

---
name: "Global Space Industries"
order: 1
logo: /global-space/global-space.png
url: "https://example.com"
---

The body of sponsor files is not used — all content comes from the frontmatter.

Required Fields

FieldTypeDescription
namestringSponsor company name
ordernumberDisplay order within the tier (lower = shown first)
logostringPath to the logo image under src/assets/sponsors/<tier>/<slug>/, written as /<slug>/<filename>

Optional Fields

FieldTypeDefaultDescription
urlstringLink to the sponsor’s website (must be a full URL)
bgColorstring#ffffffBackground color of the logo card. Use this when a sponsor’s corporate identity requires a specific background (e.g. #e20025 for a red brand).
altstringfalls back to nameAlt text used by screen readers on the sponsor logo. Override only if the sponsor name isn’t a good description.

Logo Cards & Background Color

Each sponsor logo is displayed inside a white card container with rounded corners and a soft shadow. This ensures logos look clean against the page background and satisfies corporate identity requirements for logos that must appear on a white surface.

If a sponsor’s brand guidelines require a different background color, set the bgColor field in frontmatter:

---
name: "Hetzner"
logo: /hetzner/Hetzner-Logo-slogan_white_space-red.jpg
url: "https://hetzner.com"
bgColor: "#e20025"
---

Any valid CSS color value works (#hex, rgb(), named colors). When omitted, the card defaults to white (#ffffff).

Logos

Each sponsor has its own asset subfolder under src/assets/sponsors/<tier>/<slug>/, where <tier> matches the sponsor’s tier folder and <slug> matches the filename (without extension). Place the logo there and reference it as /<slug>/<filename> (e.g. /global-space/global-space.png). Valid formats: .jpg, .jpeg, .png, .webp, .svg.

Display Order

Within each tier, sponsors are sorted in ascending order of the order field. Two sponsors with the same order fall back to alphabetical sort on the filename. The Order column in each tier’s overview in the admin UI shows each sponsor’s position.

Donations

The Sponsors page also has a direct-donations card below the sponsor CTA, with bank transfer details and a PayPal button. Its copy, bank details, and PayPal URL are edited in the page-text file src/content/page-text/{en,de}/donate.mdx — not in this src/content/sponsors/ folder. In the CMS, it shows up as the Donate singleton under Page text.

See the “Donate Card” section in Managing Page Text for the full field reference and an example.