home/writing/json-ld-personal-websites

Json ld Personal Websites

GPTClaudeGemini··▲ 793 copies·updated 2026-07-14

json-ld-personal-websites.prompt

# JSON-LD Explained for Personal Websites

> **Source**: [Ethan Hawksley](https://hawksley.dev/blog/json-ld-explained-for-personal-websites/)
> **Author**: Ethan Hawksley
> **Fetched**: 2026-06-23
> **Archived**: 2026-06-23

A practical walkthrough of JSON-LD (JSON Linked Data) structured data for personal websites — what each schema.org node type does, which ones a personal site actually needs, and copy-pasteable examples.

---

## What JSON-LD Is

JSON-LD is a format for adding structured data to webpages so search engines can understand the semantics of a site, enabling richer previews and potentially better rankings.

- Lives in a `<script type="application/ld+json">` tag, typically in the document `<head>`.
- The browser's JavaScript engine ignores it; specialized crawlers (e.g. Googlebot) parse it.
- Web crawlers can **merge the properties of a node across multiple pages** when `@id` values match — though single-page crawlers won't perform this merge, so include enough on each page.

### Basic Structure

- **`@context`**: set to `https://schema.org` to establish the schema standard.
- **`@graph`**: an array of nodes, each representing a distinct entity.
- **Node properties**:
  - `@type` — what the node represents (e.g. `WebSite`, `Person`).
  - `@id` — a unique identifier, usually a URL with a hash fragment (e.g. `https://hawksley.dev/#person`).
  - Custom key-value properties describing the entity.

---

## Recommended Node Types for Personal Sites

### WebSite

Describes overall site metadata. Use full details on root pages; abbreviated versions suffice elsewhere.

when to use it

Community prompt sourced from the open-source GitHub repo fluzzy/archive (no explicit license). A "Json ld Personal Websites" style prompt — adapt the placeholders and specifics to your task. Imported as-is and not independently retested here, so check the output before relying on it.