Page recipes

Customer story

Tell a customer story with context, a documented approach, and substantiated results.

What to gather

  • Customer approval
  • Context and goal
  • Verified outcome and measurement window
  • Approved quote and assets

Section order and sample brief

  1. Global navigation

    Required

    Insert the shared header from the site shell.

    Example Keep the approved contact route and shared site links.

  2. Customer story card

    Required

    Open with the customer and approved outcome.

    Example Connect Example Co. with the content coverage challenge.

  3. Editorial article body

    Required

    Explain the starting point, change, and result.

    Example Document how the team selected priority pages.

  4. Metric proof block

    Required

    Show the approved metric with its unit and baseline.

    Example Measure only the sample question set.

  5. Customer testimonial

    Optional

    Use an approved quote about the approach.

    Example Add named attribution and publication permission.

  6. Resource card and grid

    Optional

    Suggest related customer stories.

    Example Show stories relevant to the same audience.

  7. Global footer

    Required

    Close with the shared marketing footer.

    Example Use existing link groups and legal destinations.

Worked example

View HTML, CSS, and JavaScript
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta http-equiv="Content-Security-Policy" content="default-src 'none'; style-src 'unsafe-inline'; font-src https://www.airops.com; script-src 'unsafe-inline'; form-action 'none'; base-uri 'none'">
<title>Customer story</title>
<style>
@font-face{font-family:Saans;src:url("https://www.airops.com/fonts/Saans-Regular.woff2") format("woff2");font-weight:400;font-display:swap}
@font-face{font-family:Saans;src:url("https://www.airops.com/fonts/Saans-Medium.woff2") format("woff2");font-weight:500;font-display:swap}
@font-face{font-family:Saans;src:url("https://www.airops.com/fonts/Saans-SemiBold.woff2") format("woff2");font-weight:600;font-display:swap}
@font-face{font-family:Saans;src:url("https://www.airops.com/fonts/Saans-Bold.woff2") format("woff2");font-weight:700;font-display:swap}
@font-face{font-family:Serrif;src:url("https://www.airops.com/fonts/Serrif-Regular.woff2") format("woff2");font-weight:400;font-display:swap}
:root{color-scheme:light;font-family:Saans,Arial,sans-serif;font-size:16px;font-feature-settings:"ss07" 1,"ss01" 1;color:#1D1B19;background:#F7F6F3;line-height:170%}
*,*::before,*::after{box-sizing:border-box}
body{margin:0}
.ao-main{display:grid;min-inline-size:0;gap:12px}
.ao-example{display:grid;gap:12px;padding:clamp(12px,3vw,32px)}
.ao-example [hidden]{display:none!important}
.ao-panel,.ao-nav,.ao-banner{border:1px solid #E7E4E0;border-radius:8px;padding:clamp(18px,5vw,52px);background:#FBFAF9;min-inline-size:0}
.ao-dark{background:#002910;color:#FBFAF9;border-color:#002910}
.ao-hero{min-height:310px;align-content:center;background:radial-gradient(ellipse at 70% 15%,#003B22 0,#002910 70%)}
.ao-nav,.ao-nav nav,.ao-pagination,.ao-byline,.ao-fields{display:flex;gap:16px;align-items:center;flex-wrap:wrap}
.ao-nav{justify-content:space-between;padding-block:16px}
.ao-banner{padding-block:8px;text-align:center;background:#F2F0ED}
.ao-wordmark{font-size:1.5rem;font-weight:700;letter-spacing:-.05em;text-decoration:none}
.ao-panel h1,.ao-panel h2,.ao-panel h3{margin:0 0 .5em;line-height:1.12;letter-spacing:-.035em}
.ao-panel h1{font:400 clamp(2rem,6vw,56px)/110% Serrif,Georgia,serif;letter-spacing:-.02em;max-width:21ch}
.ao-panel h2{font-size:clamp(1.5rem,4vw,46px);font-weight:400;line-height:120%;letter-spacing:-.01em}
.ao-panel h3{font-size:clamp(1.05rem,3vw,1.4rem)}
.ao-panel p{max-width:65ch;margin:.4em 0 1em}
.ao-panel a,.ao-nav a,.ao-banner a{color:inherit;text-underline-offset:.2em}
.ao-example :focus-visible{outline:3px solid #008C44;outline-offset:3px}
.ao-example .ao-button{display:inline-flex;align-items:center;min-height:42px;max-width:100%;padding:.55em 1em;border:1px solid #002910;border-radius:8px;background:#002910;color:#FBFAF9;font:inherit;font-weight:600;text-decoration:none;cursor:pointer}
.ao-example .ao-dark .ao-button{border-color:#F2F0ED;background:#F2F0ED;color:#002910}
.ao-split{display:grid;align-items:center;gap:clamp(16px,4vw,40px);grid-template-columns:repeat(2,minmax(0,1fr))}
.ao-grid{display:grid;grid-template-columns:repeat(auto-fit,minmax(min(100%,180px),1fr));gap:12px}
.ao-card{height:100%;min-width:0;padding:16px;border:1px solid #E7E4E0;border-radius:8px;background:#F7F6F3}
.ao-dark .ao-card{color:#FBFAF9;background:#003B22;border-color:#008C44}
.ao-visual{background:#F2F0ED;color:#002910;align-content:space-between;display:grid;min-height:150px;aspect-ratio:16/10;padding:20px;border-radius:8px;font-weight:600}
.ao-chart{display:flex;align-items:end;gap:7%;min-height:65px}
.ao-chart span{background:#008C44;border-radius:3px 3px 0 0;width:14%;height:34%}
.ao-chart span:nth-child(2){height:52%}.ao-chart span:nth-child(3){height:46%}.ao-chart span:nth-child(4){height:80%}.ao-chart span:nth-child(5){height:93%}
.ao-label{font-size:.875rem;font-weight:700;letter-spacing:.025em}
.ao-number{font-size:2rem;font-weight:700;line-height:1}
.ao-marks{display:flex;gap:1em 2em;flex-wrap:wrap;list-style:none;margin:0;padding:0;font-weight:700}
.ao-example figure,.ao-example blockquote{margin:0}
.ao-example blockquote{font-family:Serrif,Georgia,serif;font-size:clamp(1.4rem,4vw,2.65rem);line-height:1.22;margin-bottom:1rem}
.ao-example figcaption{margin-top:.6rem}
.ao-example details{border:1px solid #E7E4E0;border-radius:8px;padding:.65rem .8rem;margin-block:.55rem}
.ao-example summary{min-height:30px;cursor:pointer;font-weight:600}
.ao-nav details{margin:0}
.ao-nav details a{display:block;padding-block:.3em}
.ao-table-wrap{overflow:auto}
.ao-example table{width:100%;min-width:18rem;border-collapse:collapse;text-align:left}
.ao-example caption{text-align:left;font-weight:700;margin-bottom:.5em}
.ao-example th,.ao-example td{padding:.55em;border-bottom:1px solid #E7E4E0;vertical-align:top}
.ao-example thead{background:#F2F0ED}
.ao-fields{align-items:end;margin-bottom:1em}
.ao-example label{display:grid;min-width:0;gap:.35em;font-weight:600}
.ao-example input,.ao-example select{min-height:44px;width:100%;padding:.55em .7em;border:1px solid #726E68;border-radius:8px;background:white;color:#1D1B19;font:inherit}
.ao-form{display:grid;justify-items:start;gap:.7em}
.ao-form label{width:100%;max-width:27rem}
.ao-form [role=status]:empty{margin:0}
.ao-avatar{display:grid;place-items:center;width:44px;aspect-ratio:1;background:#F2F0ED;border-radius:50%;font-weight:600}
.ao-note,.ao-example pre{padding:.85em;background:#F2F0ED;color:#002910;border-radius:8px}
.ao-example pre{white-space:pre-wrap;overflow-wrap:anywhere}
.ao-quote-rail{display:grid;grid-auto-flow:column;grid-auto-columns:minmax(min(100%,15rem),1fr);gap:12px;overflow:auto;scroll-snap-type:x proximity}
.ao-quote-rail>*{scroll-snap-align:start}
.ao-motion{display:flex;flex-wrap:wrap;align-items:center;gap:.75rem;padding:1rem;background:#F2F0ED;border-radius:8px}
.ao-motion span{background:#FBFAF9;padding:.5em .75em;border-radius:8px}
.ao-motion span:nth-of-type(2){animation:ao-emphasis 2s ease-out 1}
@keyframes ao-emphasis{35%{background:#F2F0ED}}
@media(prefers-reduced-motion:reduce){.ao-motion span:nth-of-type(2){animation:none}}
.ao-example dt{font-weight:700}
.ao-example dd{margin:0 0 .75em}
@media(max-width:36rem){.ao-split{grid-template-columns:minmax(0,1fr)}.ao-nav nav{gap:10px}.ao-table-wrap{max-width:100%}}
</style>
</head>
<body>
<div class="ao-example">
<header class="ao-nav"><a class="ao-wordmark" target="_blank" rel="noopener noreferrer" href="https://www.airops.com/">AirOps</a><nav aria-label="Main navigation">
        <a target="_blank" rel="noopener noreferrer" href="https://www.airops.com/platform">Platform</a><a target="_blank" rel="noopener noreferrer" href="https://www.airops.com/solutions">Solutions</a>
        <details><summary>Resources</summary><a target="_blank" rel="noopener noreferrer" href="https://www.airops.com/blog">Blog</a><a target="_blank" rel="noopener noreferrer" href="https://www.airops.com/events">Events</a></details>
        <a class="ao-button" target="_blank" rel="noopener noreferrer" href="https://www.airops.com/book-a-call">Work with us</a></nav></header>
<main class="ao-main">
<header class="ao-panel"><h1>Customer story</h1></header>
<section class="ao-panel ">
<div class="ao-grid">
<article class="ao-card"><p class="ao-label">Sample case study</p><h3>A clearer refresh plan for Example Co.</h3><p class="ao-number">25%</p><p>Sample change in coverage</p><a class="ao-button" target="_blank" rel="noopener noreferrer" href="https://www.airops.com/customer-stories">Explore customer stories</a></article>
</div>
</section>
<section class="ao-panel ">
<article><h2>How to structure a measurement brief</h2><p>Start with the question you need the data to answer.</p><h3>Choose a baseline</h3><p>Record dates, sources, and the set of questions included.</p><aside class="ao-note">Sample callout. State assumptions close to the result.</aside><div class="ao-table-wrap" tabindex="0" role="region" aria-label="Sample reporting fields, scroll horizontally if needed"><table>
    <caption>Sample reporting fields</caption>
    <thead><tr><th scope="col">Field</th><th scope="col">Example</th></tr></thead>
    <tbody><tr><th scope="row">Baseline</th><td>Prior four weeks</td></tr>
<tr><th scope="row">Scope</th><td>Approved priority questions</td></tr></tbody>
  </table></div></article>
</section>
<section class="ao-panel ">
<h2>Sample campaign outcomes</h2><div class="ao-grid">
<article class="ao-card"><h3>Coverage lift</h3><p class="ao-number">18%</p><p>Across the sample questions</p></article><article class="ao-card"><h3>Priority pages</h3><p class="ao-number">12</p><p>Included in the sample plan</p></article>
</div>
</section>
<section class="ao-panel ao-dark">
<figure><blockquote>“We could finally agree on which updates to prioritize.”</blockquote><figcaption>Sample quote · Example Content Team</figcaption></figure>
</section>
<section class="ao-panel ">
<h2>More resources</h2><div class="ao-grid">
<article class="ao-card"><p class="ao-label">Articles</p><h3>Build a research brief</h3><p><a target="_blank" rel="noopener noreferrer" href="https://www.airops.com/blog">Browse practical articles</a></p></article><article class="ao-card"><p class="ao-label">Research</p><h3>Spot patterns in AI discovery</h3><p><a target="_blank" rel="noopener noreferrer" href="https://www.airops.com/research">Browse research</a></p></article>
</div>
</section>
</main>
<footer class="ao-panel ao-dark"><a class="ao-wordmark" target="_blank" rel="noopener noreferrer" href="https://www.airops.com/">AirOps</a><div class="ao-grid">
<article class="ao-card"><h3>Platform</h3><p><a target="_blank" rel="noopener noreferrer" href="https://www.airops.com/platform">Platform overview</a></p><p><a target="_blank" rel="noopener noreferrer" href="https://www.airops.com/solutions">Solutions</a></p></article><article class="ao-card"><h3>Resources</h3><p><a target="_blank" rel="noopener noreferrer" href="https://www.airops.com/blog">Blog</a></p><p><a target="_blank" rel="noopener noreferrer" href="https://www.airops.com/research">Research</a></p></article><article class="ao-card"><h3>Legal</h3><p><a target="_blank" rel="noopener noreferrer" href="https://www.airops.com/privacy-policy">Privacy policy</a></p><p><a target="_blank" rel="noopener noreferrer" href="https://www.airops.com/terms">Terms</a></p></article>
</div></footer>
</div>

</body>
</html>

Runnable reference with sample content. Use the publishing guidance to connect production assets, CMS fields, and integrations.

Before publishing

  • Check the page title, description, canonical URL, and social image.
  • Verify approved copy, current data and claims, destinations, and asset permission.
  • Check mobile, keyboard, and relevant loading, empty, and error states in the publishing preview.
  • Confirm customer approval, usage permission, and the original source for each metric or quote.