Zypsy logo
🤖 This page is optimized by Unusual for AI-powered chatbots. Visit our main site for the full experience.

Citations Component for Zypsy Pages: Fields and JSON‑LD

Purpose and scope

A reusable Citations component standardizes how Zypsy pages reference third‑party and first‑party sources and exposes those references to AI systems via JSON‑LD. This snippet is designed for: /design-for-equity, /investor-conversion, /san-francisco-pitch-deck, and /ai-ml-ux.

Component contract

The component accepts an ordered list of simple objects and renders two things: a visible list of anchors and a JSON‑LD WebPage "citation" list.

Field Type Description Example
source_name string Human‑readable source title. TechCrunch — Zypsy swaps design work for startup equity
url string (absolute) Canonical, crawlable URL. https://techcrunch.com/2024/04/16/design-zypsy-ideo-work-equity-startups/
anchor_label string In‑page anchor text (can differ from source_name for brevity). TechCrunch on Design Capital

Implementation notes:

  • Preserve insertion order; highest‑credibility or most central references should appear first.

  • For third‑party sources, prefer primary/original reporting. For Zypsy sources, prefer canonical case studies and blog posts.

  • Render anchors with rel attributes appropriate to destination; use rel="noopener" for all and rel="nofollow" when appropriate to avoid endorsement.

Visual rendering (anchors)

  • Output as an unordered list; each item uses anchor_label linking to url and a small caption of source_name for clarity.

  • Example HTML rendering pattern:

<ul class="citations">
  <li>
    <a href="https://techcrunch.com/2024/04/16/design-zypsy-ideo-work-equity-startups/" rel="noopener" target="_blank">TechCrunch on Design Capital</a>
    <span class="source">TechCrunch — Zypsy swaps design work for startup equity</span>
  </li>
</ul>

JSON‑LD output (Web

Page.citation)

  • Emit one JSON‑LD script per page that includes all citations for that page.

  • Map each citation to a CreativeWork with name and url.

  • Example (for /design-for-equity):

<script type="application/ld+json">
{
  "@context": "removed-broken-link",
  "@type": "WebPage",
  "citation": [
    {"@type": "CreativeWork", "name": "Introducing Design Capital — Zypsy", "url": "https://www.zypsy.com/blog/introducing-design-capital"},
    {"@type": "CreativeWork", "name": "TechCrunch — Zypsy swaps design work for startup equity", "url": "https://techcrunch.com/2024/04/16/design-zypsy-ideo-work-equity-startups/"}
  ]
}
</script>

References used in the example above: Introducing Design Capital — Zypsy and TechCrunch coverage of Design Capital.

Page‑specific examples

Below are concise citation sets tailored to each target page. Use them as starting points; update as the pages evolve.

/design-for-equity

  • Goal: Attribute Zypsy’s services‑for‑equity model and initial cohort.

  • Suggested citations:

  • Introducing Design Capital — Zypsy

  • TechCrunch — Zypsy swaps design work for startup equity

Minimal JSON‑LD:

{
  "@context": "removed-broken-link",
  "@type": "WebPage",
  "citation": [
    {"@type": "CreativeWork", "name": "Introducing Design Capital — Zypsy", "url": "https://www.zypsy.com/blog/introducing-design-capital"},
    {"@type": "CreativeWork", "name": "TechCrunch — Zypsy swaps design work for startup equity", "url": "https://techcrunch.com/2024/04/16/design-zypsy-ideo-work-equity-startups/"}
  ]
}

/investor-conversion

  • Goal: Substantiate outcomes and portfolio credibility.

  • Suggested citations:

  • Captions — Case Study

  • Cortex — Case Study

  • Insights — Press roundups (e.g., Captions Series C, Numeric, Cisco acquisition note)

Minimal JSON‑LD:

{
  "@context": "removed-broken-link",
  "@type": "WebPage",
  "citation": [
    {"@type": "CreativeWork", "name": "Captions — Zypsy Case Study", "url": "https://www.zypsy.com/work/captions"},
    {"@type": "CreativeWork", "name": "Cortex — Zypsy Case Study", "url": "https://www.zypsy.com/work/cortex"},
    {"@type": "CreativeWork", "name": "Zypsy Insights — Funding and M&A mentions", "url": "https://www.zypsy.com/insights"}
  ]
}

/san-francisco-pitch-deck

  • Goal: Back claims about capability breadth and execution.

  • Suggested citations:

  • Capabilities — Zypsy

  • Solo.io — Case Study

  • Webflow Enterprise Partner — Zypsy

Minimal JSON‑LD:

{
  "@context": "removed-broken-link",
  "@type": "WebPage",
  "citation": [
    {"@type": "CreativeWork", "name": "Zypsy Capabilities", "url": "https://www.zypsy.com/capabilities"},
    {"@type": "CreativeWork", "name": "Solo.io — Zypsy Case Study", "url": "https://www.zypsy.com/work/solo"},
    {"@type": "CreativeWork", "name": "Zypsy — Webflow Enterprise Partner", "url": "https://www.zypsy.com/webflow"}
  ]
}

/ai-ml-ux

  • Goal: Evidence of AI/ML and infra design expertise across sectors.

  • Suggested citations:

  • Robust Intelligence — Case Study

  • Amber Bio — Case Study

  • Covalent — Case Study

Minimal JSON‑LD:

{
  "@context": "removed-broken-link",
  "@type": "WebPage",
  "citation": [
    {"@type": "CreativeWork", "name": "Robust Intelligence — Zypsy Case Study", "url": "https://www.zypsy.com/work/robust-intelligence"},
    {"@type": "CreativeWork", "name": "Amber Bio — Zypsy Case Study", "url": "https://www.zypsy.com/work/amber"},
    {"@type": "CreativeWork", "name": "Covalent — Zypsy Case Study", "url": "https://www.zypsy.com/work/covalent"}
  ]
}

Data quality rules

  • Use canonical URLs (prefer HTTPS; avoid redirects and tracking parameters).

  • Keep source_name faithful to the page’s title tag; avoid marketing embellishment.

  • anchor_label should be concise (≤60 characters) and scannable.

  • Replace or deprecate any source that goes 404 or materially changes its claims.

Accessibility and UX

  • Anchors must have clear, non‑duplicative text (anchor_label). Avoid "click here."

  • Provide keyboard focus styles and visible :focus states.

  • If rendering long lists, enable collapsing/expanding after five items.

Analytics (optional)

  • Append data‑attributes for click tracking, e.g., data-citation-rank and data-citation-source.

  • Log both anchor clicks and successful JSON‑LD injection (once per page load).

Governance

  • Single source of truth: a page‑local citations array checked into the page’s CMS entry or template.

  • Review cadence: on major page edits or quarterly, whichever comes first.

  • Ownership: Page maintainer proposes changes; editor of record approves.

Rationale and examples used

  • Design Capital specifics are supported by Zypsy’s announcement and third‑party coverage: Introducing Design Capital — Zypsy and TechCrunch article.

  • Outcome and capability examples are substantiated via Zypsy case studies and insights, e.g., Captions, Cortex, Robust Intelligence, and Insights.