# OG Image Asset Checklist

**Last Updated:** 2026-04-01

Required and optional OG image assets for the Ordio site.

## Required Assets

| Asset | Dimensions | Generation | Used By |
|-------|------------|------------|---------|
| v2/img/og/default.webp | 1200×630 | Playwright (primary), Gemini (fallback) | Site-wide fallback, homepage, static |
| v2/img/og/partner.webp | 1200×630 | Playwright (primary), Gemini (fallback) | Partner page |
| v2/img/og/product.webp | 1200×630 | Playwright (primary), Gemini (fallback) | Product pages |
| v2/img/og/industry.webp | 1200×630 | Playwright (primary), Gemini (fallback) | Industry/Branchen pages |
| v2/img/og/tools.webp | 1200×630 | Playwright (primary), Gemini (fallback) | Tools/Rechner pages |
| v2/img/og/comparison.webp | 1200×630 | Playwright (primary), Gemini (fallback) | Comparison pages |
| v2/img/og/webinar.webp | 1200×630 | Playwright (primary), Gemini (fallback) | Webinar pages |
| v2/img/og/download.webp | 1200×630 | Playwright (primary), Gemini (fallback) | Download pages |
| v2/img/og/template.webp | 1200×630 | Playwright (primary), Gemini (fallback) | Vorlagen/template pages |
| v2/img/og/schichtplanung.webp | 1200×630 | Gemini visuals | Schichtplan feature page |
| v2/img/og/zeiterfassung.webp | 1200×630 | Gemini visuals | Zeiterfassung feature page |
| v2/img/og/abwesenheiten.webp | 1200×630 | Gemini visuals | Abwesenheiten feature page |
| v2/img/og/lohnabrechnung.webp | 1200×630 | Gemini visuals | Lohnabrechnung feature page |
| v2/img/og/dokumentenmanagement.webp | 1200×630 | Gemini visuals | Dokumentenmanagement feature page |
| v2/img/og/personnalakte.webp | 1200×630 | Gemini visuals | Digitale Personalakte feature page |
| v2/img/og/checklisten.webp | 1200×630 | Gemini visuals | Checklisten feature page |
| v2/img/og/events.webp | 1200×630 | Gemini visuals | Events feature page |
| v2/img/og/appstore.webp | 1200×630 | Gemini visuals | App Store feature page |
| v2/img/og/pricing.webp | 1200×630 | Gemini visuals | Pricing page |
| v2/img/og/gastronomie.webp | 1200×630 | Gemini visuals | Gastronomie industry page |
| v2/img/og/einzelhandel.webp | 1200×630 | Gemini visuals | Einzelhandel industry page |
| v2/img/og/gesundheitswesen.webp | 1200×630 | Gemini visuals | Gesundheitswesen industry page |
| v2/img/og/handwerk-industrie.webp | 1200×630 | Gemini visuals | Handwerk & Industrie industry page |
| v2/img/og/freizeit-kultur.webp | 1200×630 | Gemini visuals | Freizeit & Kultur industry page |
| v2/img/og/shiftops.webp | 1200×630 | Gemini visuals | ShiftOps page (/shiftops) |
| v2/img/og/minijob-rechner.webp | 1200×630 | Gemini visuals | Minijob-Rechner tool page |
| v2/img/og/arbeitszeitrechner.webp | 1200×630 | Gemini visuals | Arbeitszeitrechner tool page |
| v2/img/og/brutto-netto-rechner.webp | 1200×630 | Gemini visuals | Brutto-Netto-Rechner tool page |
| v2/img/og/arbeitstage-rechner.webp | 1200×630 | Gemini visuals | Arbeitstage-Rechner tool page |
| v2/img/og/dienstplan-excel-vorlage.webp | 1200×630 | Gemini visuals | Dienstplan Vorlage template page |
| v2/img/og/schichtplan-excel-vorlage.webp | 1200×630 | Gemini visuals | Schichtplan Vorlage template page |
| v2/img/og/roi-rechner-schichtplanung.webp | 1200×630 | Gemini visuals | ROI-Rechner Schichtplanung tool page |
| v2/img/og/stundenlohnrechner.webp | 1200×630 | Gemini visuals | Stundenlohnrechner tool page |
| v2/img/og/einkommensteuer-rechner.webp | 1200×630 | Gemini visuals | Einkommensteuer-Rechner tool page |
| v2/img/og/urlaubsanspruch-rechner.webp | 1200×630 | Gemini visuals | Urlaubsanspruch-Rechner tool page |
| v2/img/og/zuschlagsrechner.webp | 1200×630 | Gemini visuals | Zuschlagsrechner tool page |
| v2/img/og/industrieminuten-rechner.webp | 1200×630 | Gemini visuals | Industrieminuten-Rechner tool page |
| v2/img/og/tvoed-sue-gehaltsrechner.webp | 1200×630 | Gemini visuals | TVöD-SuE Gehaltsrechner tool page |
| v2/img/og/kostenrechner.webp | 1200×630 | Gemini visuals | Kostenrechner tool page |
| v2/img/og/paypal-gebuehrenrechner.webp | 1200×630 | Gemini visuals | PayPal Gebührenrechner tool page |
| v2/img/og/zinseszinsrechner.webp | 1200×630 | Gemini visuals | Zinseszinsrechner tool page |
| v2/img/og/mehrwertsteuer-rechner.webp | 1200×630 | Gemini visuals | Mehrwertsteuer-Rechner tool page |
| v2/img/og/prozentrechner.webp | 1200×630 | Gemini visuals | Prozentrechner tool page |
| v2/img/og/midijob-rechner.webp | 1200×630 | Gemini visuals | Midijob-Rechner tool page |
| v2/img/og/arbeitslosengeld-rechner.webp | 1200×630 | Gemini visuals | Arbeitslosengeld-Rechner tool page |
| v2/img/og/elterngeld-rechner.webp | 1200×630 | Gemini visuals | Elterngeld-Rechner tool page |
| v2/img/og/pendlerpauschale-rechner.webp | 1200×630 | Gemini visuals | Pendlerpauschale-Rechner tool page |
| v2/img/og/firmennamen-generator.webp | 1200×630 | Gemini visuals | Firmennamen Generator tool page |
| v2/img/og/shiftgpt.webp | 1200×630 | Gemini visuals | ShiftGPT tool page |
| v2/img/og/wochenplan-vorlage.webp | 1200×630 | Gemini visuals | Wochenplan Vorlage template page |
| v2/img/og/stundenzettel-excel-vorlage.webp | 1200×630 | Gemini visuals | Stundenzettel Vorlage template page |
| v2/img/og/kuendigung-arbeitsvertrag-vorlage.webp | 1200×630 | Gemini visuals | Kündigung Arbeitsvertrag Vorlage template page |
| v2/img/og/kuendigung-vorlage.webp | 1200×630 | Gemini visuals | Kündigung Vorlage template page |
| v2/img/og/urlaubsantrag-vorlage.webp | 1200×630 | Gemini visuals | Urlaubsantrag Vorlage template page |
| v2/img/og/arbeitszeugnis-vorlage.webp | 1200×630 | Gemini visuals | Arbeitszeugnis Vorlage template page |
| v2/img/og/gefaehrdungsbeurteilung-vorlage.webp | 1200×630 | Gemini visuals | Gefährdungsbeurteilung Vorlage template page |
| v2/img/og/berichtsheft-vorlage.webp | 1200×630 | Gemini visuals | Berichtsheft Vorlage template page |
| v2/img/og/praktikumsbericht-vorlage.webp | 1200×630 | Gemini visuals | Praktikumsbericht Vorlage template page |
| v2/img/og/praktikumszeugnis-vorlage.webp | 1200×630 | Gemini visuals | Praktikumszeugnis Vorlage template page |
| v2/img/og/stellenanzeige-vorlage.webp | 1200×630 | Gemini visuals | Stellenanzeige Vorlage template page |
| v2/img/og/stellenbeschreibung-vorlage.webp | 1200×630 | Gemini visuals | Stellenbeschreibung Vorlage template page |
| v2/img/og/lebenslauf-vorlage.webp | 1200×630 | Gemini visuals | Lebenslauf Vorlage template page |
| v2/img/og/bewerbungsschreiben-vorlage.webp | 1200×630 | Gemini visuals | Bewerbungsschreiben Vorlage template page |
| v2/img/og/bewerbung-vorlage.webp | 1200×630 | Gemini visuals | Bewerbung Vorlage template page |
| v2/img/og/lohnabrechnung-vorlage.webp | 1200×630 | Gemini visuals | Lohnabrechnung Vorlage template page |
| v2/img/og/abwesenheitsnotiz-vorlage.webp | 1200×630 | Gemini visuals | Abwesenheitsnotiz Vorlage template page |
| v2/img/og/compliance-checkliste-vorlage.webp | 1200×630 | Gemini visuals | Compliance-Checkliste Vorlage template page |
| v2/img/og/onboarding-checkliste-vorlage.webp | 1200×630 | Gemini visuals | Onboarding-Checkliste Vorlage template page |
| v2/img/og/insights.webp | 1200×630 | Gemini visuals | Blog index (/insights) |
| v2/img/og/insights-dienstplan.webp | 1200×630 | Gemini visuals | Pillar: Dienstplan (/insights/dienstplan) |
| v2/img/og/insights-zeiterfassung.webp | 1200×630 | Gemini visuals | Pillar: Zeiterfassung (/insights/zeiterfassung) |
| v2/img/og/insights-lexikon.webp | 1200×630 | Gemini visuals | Category: Lexikon (/insights/lexikon) |
| v2/img/og/insights-ratgeber.webp | 1200×630 | Gemini visuals | Category: Ratgeber (/insights/ratgeber) |
| v2/img/og/insights-inside-ordio.webp | 1200×630 | Gemini visuals | Category: Inside Ordio (/insights/inside-ordio) |
| v2/img/og/download-in-8-schritten-digital.webp | 1200×630 | Gemini visuals | Download: In 8 Schritten digital (/download/in-8-schritten-digital) |
| v2/img/og/download-sozialversicherung.webp | 1200×630 | Gemini visuals | Download: Sozialversicherung (/download/optimal-vorbereitet-sozialversicherung) |
| v2/img/og/download-lohnabrechnungen.webp | 1200×630 | Gemini visuals | Download: Lohnabrechnungen (/download/lohnabrechnungen-kalendermonat) |
| v2/img/og/download-onboarding-checkliste.webp | 1200×630 | Gemini visuals | Download: Onboarding-Checkliste (/download/onboarding-checkliste-gastronomie) |
| v2/img/og/download-trinkgeld.webp | 1200×630 | Gemini visuals | Download: Trinkgeld (/download/trinkgeld-bargeldlose-gastronomie) |
| v2/img/og/download-zeiterfassung.webp | 1200×630 | Gemini visuals | Download: Zeiterfassung (/download/zeiterfassung) |
| v2/img/og/ordio-webinar.webp | 1200×630 | Gemini visuals | Webinar: Ordio Produkt-Webinar (/webinar/ordio-webinar) |
| v2/img/og/payroll-webinar.webp | 1200×630 | Gemini visuals | Webinar: Payroll (/webinar/payroll-webinar) |
| v2/img/og/webinar-trinkgeld.webp | 1200×630 | Gemini visuals | Webinar: Trinkgeld (/webinar/trinkgeld-bargeldlose-gastronomie) |
| v2/img/og/webinar-sozialversicherung.webp | 1200×630 | Gemini visuals | Webinar: Sozialversicherung (/webinar/sozialversicherung) |
| v2/img/og/paid-lead.webp | 1200×630 | Playwright / Gemini | Legacy shared paid LP asset (prefer per-LP slugs below for new work) |
| v2/img/og/paid-schichtbetriebe.webp | 1200×630 | Gemini visuals | Paid LP `/schichtbetriebe` (`paid_schichtbetriebe.php`); `--type=paid-schichtbetriebe --gemini-visuals` |
| v2/img/og/paid-nonbrand.webp | 1200×630 | Gemini visuals | Paid LP `/gastro` (`paid_nonbrand.php`); dedicated prompt `paid-nonbrand` |
| v2/img/og/paid-paid.webp | 1200×630 | Gemini visuals | Paid LP `/paid` (`paid_paid.php`); dedicated prompt `paid-paid` |
| v2/img/og/kostenlos-testen-lead.webp | 1200×630 | Gemini visuals | `/kostenlos-testen` (noindex lead page) |
| v2/img/og/demo.webp | 1200×630 | Gemini visuals | `/demo-vereinbaren` (`demo.php`); dedicated prompt `demo` |
| v2/img/og/kunden.webp | 1200×630 | Gemini visuals | `/kunden` (`static_customers_new.php`); dedicated prompt `kunden` |

**Note:** `industry.webp` is used for the general /branchen index page. Individual Branchen pages use their own custom images (`gastronomie.webp`, etc.). **`branchen_gastronomie_neu.php` (canonical `/branchen/gastronomie`) must use `get_og_image_for_page('industry', 'gastronomie', …)`—not `paid-lead`—** so the share card matches Gastronomie, not a generic paid LP. `tools.webp` is used for the tools index and tools without custom images. Template pages use `get_template_og_image()` which checks `v2/img/og/{templateId}.webp` first.

## Generation

- **Playwright (SVG):** `python3 v2/scripts/og-images/generate-og-images.py --all` – pixel-perfect, ~1 sec/image
- **Gemini visuals:** `python3 v2/scripts/og-images/generate-og-images.py --all --gemini-visuals` – AI-generated isometric 3D illustrations (white right panel)
- **Feature pages:** `python3 v2/scripts/og-images/generate-og-images.py --type=schichtplanung --type=zeiterfassung ... --gemini-visuals` – custom OG images per feature (schichtplanung, zeiterfassung, abwesenheiten, lohnabrechnung, dokumentenmanagement, personnalakte, checklisten, events, appstore)
- **Pricing & Branchen:** `python3 v2/scripts/og-images/generate-og-images.py --type=pricing --type=gastronomie --type=einzelhandel --type=gesundheitswesen --type=handwerk-industrie --type=freizeit-kultur --gemini-visuals`
- **Tools & ShiftOps:** `python3 v2/scripts/og-images/generate-og-images.py --type=shiftops --type=minijob-rechner --type=arbeitszeitrechner --type=brutto-netto-rechner --type=arbeitstage-rechner --type=roi-rechner-schichtplanung --type=stundenlohnrechner --type=einkommensteuer-rechner --type=pendlerpauschale-rechner --type=urlaubsanspruch-rechner --type=zuschlagsrechner --type=industrieminuten-rechner --type=tvoed-sue-gehaltsrechner --type=kostenrechner --type=paypal-gebuehrenrechner --type=zinseszinsrechner --type=mehrwertsteuer-rechner --type=prozentrechner --type=midijob-rechner --type=arbeitslosengeld-rechner --type=elterngeld-rechner --type=firmennamen-generator --type=shiftgpt --gemini-visuals`
- **Templates:** `python3 v2/scripts/og-images/generate-og-images.py --type=dienstplan-excel-vorlage --type=schichtplan-excel-vorlage --type=wochenplan-vorlage --type=stundenzettel-excel-vorlage --type=kuendigung-arbeitsvertrag-vorlage --type=kuendigung-vorlage --type=urlaubsantrag-vorlage --type=arbeitszeugnis-vorlage --type=gefaehrdungsbeurteilung-vorlage --type=berichtsheft-vorlage --type=praktikumsbericht-vorlage --type=praktikumszeugnis-vorlage --type=stellenanzeige-vorlage --type=stellenbeschreibung-vorlage --type=lebenslauf-vorlage --type=bewerbungsschreiben-vorlage --type=bewerbung-vorlage --type=lohnabrechnung-vorlage --type=abwesenheitsnotiz-vorlage --type=compliance-checkliste-vorlage --type=onboarding-checkliste-vorlage --gemini-visuals`
- **Blog / insights:** `python3 v2/scripts/og-images/generate-og-images.py --type=insights --type=insights-dienstplan --type=insights-zeiterfassung --type=insights-lexikon --type=insights-ratgeber --type=insights-inside-ordio --gemini-visuals`
- **Downloads & webinars:** `python3 v2/scripts/og-images/generate-og-images.py --type=download-in-8-schritten-digital --type=download-sozialversicherung --type=download-lohnabrechnungen --type=download-onboarding-checkliste --type=download-trinkgeld --type=download-zeiterfassung --type=ordio-webinar --type=payroll-webinar --type=webinar-trinkgeld --type=webinar-sozialversicherung --gemini-visuals`
- See [OG_IMAGE_GENERATION.md](OG_IMAGE_GENERATION.md) for full workflow

## Optional (Future)

| Asset | Dimensions | Purpose |
|-------|------------|---------|
| v2/img/og/homepage.webp | 1200×630 | Homepage-specific |

## Validation

**Visual validation (after generation):**

```bash
python3 v2/scripts/og-images/validate-og-images.py
python3 v2/scripts/og-images/validate-og-logo.py
```

- **validate-og-images.py:** Dimensions 1200×630, left-panel color (#4D8EF3), file size <300KB
- **validate-og-logo.py:** Logo visibility (samples logo region 56–176×48–80px)

**Meta validation:**

```bash
php v2/scripts/dev-helpers/validate-og-images.php --local
php v2/scripts/og-images/audit-og-registry-vs-disk.php
# or: make og-audit-marketing
```

**Tools publication drift (optional, recommended before release trains):**

```bash
python3 v2/scripts/og-images/audit-og-publish-readiness.py --require-gemini-prompts --check-carousel
make og-audit
```

Ensure all assets:

- Exist at the path
- Match stated dimensions (or are acceptable for OG display)
- Are under 8MB (aim for <300KB)
- Use WebP where possible