---
title: "JSON-LD @id references don't resolve (geo/jsonld-id-unresolved)"
description: "geo/jsonld-id-unresolved: A {\"@id\": …} reference that matches no node on the page or the home page graph leaves publisher/author links dangling; relative…"
canonical: https://void-design.vercel.app/rules/geo/jsonld-id-unresolved
lastModified: 2026-09-16
---

# JSON-LD @id references don't resolve

`geo/jsonld-id-unresolved` · severity **warn** · category AI search · detected by `void geo` and `void audit`

## Why it matters

A {"@id": …} reference that matches no node on the page or the home page graph leaves publisher/author links dangling; relative @ids resolve inconsistently.

## How to fix it

Use absolute, stable @ids (https://site/#org, https://site/#website, https://site/page#article) and define each referenced node once (Organization on the home page).

## References

- https://www.w3.org/TR/json-ld11/#node-identifiers
- https://developers.google.com/search/docs/appearance/structured-data/intro-structured-data

## More ai search rules

`void geo` reports 41 rules in this category. Generative-engine optimisation: whether AI crawlers that don't run JavaScript see the same content, valid and visible JSON-LD, an explicit AI robots policy, llms.txt, Markdown mirrors and answer-first writing.

- `jsonld-recommended` Structured data missing recommended properties — [geo/jsonld-recommended](https://void-design.vercel.app/rules/geo/jsonld-recommended)
- `jsonld-dates` Structured data dates are invalid, lack a timezone, or modified < published — [geo/jsonld-dates](https://void-design.vercel.app/rules/geo/jsonld-dates)
- `breadcrumb-invalid` BreadcrumbList positions, names or item URLs are invalid — [geo/breadcrumb-invalid](https://void-design.vercel.app/rules/geo/breadcrumb-invalid)
- `faq-deprecated` FAQPage/HowTo/SearchAction markup no longer produces rich results — [geo/faq-deprecated](https://void-design.vercel.app/rules/geo/faq-deprecated)
- `jsonld-not-visible` Structured data values don't appear on the page — [geo/jsonld-not-visible](https://void-design.vercel.app/rules/geo/jsonld-not-visible)
- `entity-name-mismatch` Brand name differs across og:site_name, JSON-LD and title — [geo/entity-name-mismatch](https://void-design.vercel.app/rules/geo/entity-name-mismatch)
- `article-date-missing` Article has no machine-readable or visible date — [geo/article-date-missing](https://void-design.vercel.app/rules/geo/article-date-missing)
- `article-author-missing` Article author missing or malformed — [geo/article-author-missing](https://void-design.vercel.app/rules/geo/article-author-missing)

Detected by `void geo` and `void audit`. Explain it in a terminal: `void rules geo/jsonld-id-unresolved`