Guides
Registry
Host your resume at registry.jsonresume.org from a GitHub gist.
The registry renders any public GitHub gist named resume.json. There is no
sign-up: create the gist and the URL works.
Publish
- Create a public gist at gist.github.com with
a file named
resume.json. - Open
https://registry.jsonresume.org/<your-github-username>.
Edit the gist to update your resume. Rendered pages can be cached, so a change may take a while to show; error pages are never cached.
Themes
The theme is chosen in this order:
?theme=<name>in the URL, e.g.registry.jsonresume.org/jane?theme=evenmeta.themein your resume:{ "meta": { "theme": "even" } }- the default theme
?theme=random picks a random theme. The full list is in the
theme gallery.
Formats
Add an extension to get your resume in another format:
| URL | Output |
|---|---|
/<username> | HTML, rendered with your theme |
/<username>.json | the raw resume JSON |
/<username>.yaml | YAML |
/<username>.txt | plain text |
/<username>.pdf | PDF, rendered with your theme |
/<username>.rendercv | RenderCV YAML |
/<username>.qr | a QR code linking to your resume |
/<username>.agent | Markdown written for AI agents and LLM tools |
More than one resume
Keep several resume gists and pick one with ?gistname=:
https://registry.jsonresume.org/jane?gistname=resume-de.jsonErrors
| Status | Meaning |
|---|---|
| 404 | No GitHub user with that name, no public resume.json gist, or an unknown theme |
| 400 | The resume is not valid JSON or doesn't match the schema; the page lists each problem |
| 503 | GitHub could not be reached (rate limit or outage); try again shortly |
Data formats (.json, .yaml, ...) return errors as JSON; page requests
return an HTML error page.