Page recipes

Resource or directory listing

Help a reader navigate a collection and find the right detail page.

What to gather

  • Collection and taxonomy
  • Approved featured items
  • Result card mapping
  • Query and pagination behavior

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. Featured resource

    Optional

    Feature one current editorial priority.

    Example Pin one relevant report with a clear destination.

  3. Filterable resource listing

    Required

    Expose the search or filters readers need.

    Example Use guide and research categories with a no-results state.

  4. Resource card and grid

    Required

    Map each record to the shared listing card.

    Example Display only fields supported by the collection.

  5. Collection pagination

    Optional

    Preserve navigation across results pages.

    Example Check links with filters applied.

  6. 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>Resource or directory listing</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>Resource or directory listing</h1></header>
<section class="ao-panel ">
<div class="ao-split"><div><p class="ao-label">Featured research</p><h2>What changes when teams measure AI discovery?</h2><p>A sample editorial feature with one primary destination.</p><a class="ao-button" target="_blank" rel="noopener noreferrer" href="https://www.airops.com/research">Browse research</a></div><div class="ao-visual"><span>Sample report cover</span><div aria-hidden="true" class="ao-chart"><span></span><span></span><span></span><span></span><span></span></div></div></div>
</section>
<section class="ao-panel ">
<h2>Find a resource</h2><div data-ao-filter>
  <div class="ao-fields"><label>Search resources<input type="search" data-ao-query placeholder="Search"></label>
  <label>Category<select data-ao-category><option value="">All</option><option value="guides">Guides</option><option value="research">Research</option></select></label></div>
  <p data-ao-count role="status"></p>
  <div class="ao-grid"><div data-ao-result data-category="guides"><article class="ao-card"><h3>Build an AI search brief</h3><p>Guide · Start with the audience.</p></article></div><div data-ao-result data-category="research"><article class="ao-card"><h3>What teams measure</h3><p>Research · Compare useful signals.</p></article></div></div>
  <p data-ao-empty hidden>No matches. Try a different search or category.</p>
</div>
</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>
<section class="ao-panel ">
<nav class="ao-pagination" aria-label="Sample listing pages"><span aria-current="page">Page 1</span><span>Next-page link uses the collection’s resolved URL.</span><a target="_blank" rel="noopener noreferrer" href="https://www.airops.com/blog">View the live blog listing</a></nav>
</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>
<script>
document.querySelectorAll('[data-ao-filter]').forEach((group) => {
  const query = group.querySelector('[data-ao-query]');
  const category = group.querySelector('[data-ao-category]');
  const count = group.querySelector('[data-ao-count]');
  const empty = group.querySelector('[data-ao-empty]');
  const records = [...group.querySelectorAll('[data-ao-result]')];

  function filter() {
    const phrase = query.value.trim().toLowerCase();
    let visible = 0;

    for (const record of records) {
      const matchesText = record.textContent.toLowerCase().includes(phrase);
      const matchesCategory = !category.value || record.dataset.category === category.value;
      record.hidden = !(matchesText && matchesCategory);
      if (!record.hidden) visible++;
    }

    count.textContent = visible === 1 ? '1 result' : visible + ' results';
    empty.hidden = visible !== 0;
  }

  query.addEventListener('input', filter);
  category.addEventListener('change', filter);
  filter();
});
</script>
</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.
  • Check empty, partial, and long result lists. Confirm the live query owns sorting and pagination.