Docs

Quickstart

sharehtml.org is a file-sharing service that turns a single HTML file into a link. Upload or paste HTML, get https://name.sharehtml.org. No account.

Free pages are 5 MB, about 25 per person, unlisted, kept forever and served byte-for-byte on their own origin. Pro ($5 a month or $40 a year) adds private pages, custom names, 25 MB, version history, view counts and publish-to-search.

• API reference: every endpoint, body form, error code.
• Limits: sizes, quotas, rate limits, retention, takedowns.
• For agents: the publish step for Claude Code, Cursor and friends.
• llms.txt: the machine-readable index.

1. Browser

1. Open sharehtml.org.
2. Drop an .html file on the box, or paste the code into it.
3. Copy the link. Keep the management link too: it lets you replace or delete the page later.

Sign in with GitHub or Google to see all your pages in one place and to claim pages you uploaded anonymously from the same browser. Signing in is optional.

2. curl

curl -X POST https://sharehtml.org/api/v1/pages \
  -H 'Content-Type: text/html' \
  --data-binary @page.html

Returns 201 with:

{
  "id": "2b6f0c1e-7d2a-4d5a-9b1c-4f2e8a9d3c71",
  "url": "https://k3x9q2a.sharehtml.org/",
  "slug": "k3x9q2a",
  "bytes": 18342,
  "visibility": "unlisted",
  "status": "active",
  "manageUrl": "https://sharehtml.org/m/<manage-key>",
  "manageKey": "<manage-key>",
  "qrSvg": "<svg ...>"
}

url is the link. manageKey is shown once; it is the only way to change an anonymous page. Update the same link later with PUT:

curl -X PUT https://sharehtml.org/api/v1/pages/<id> \
  -H 'Content-Type: text/html' \
  -H 'X-Manage-Key: <manage-key>' \
  --data-binary @page.html

Without a token, curl uploads are limited to 10 a day per IP. Signed-in uploads useAuthorization: Bearer with an API token from your dashboard.

3. Coding agents

Any agent that can run curl or fetch can publish. The for agents page has the JSON body form, the update step and a six-line snippet for AGENTS.md or CLAUDE.md.

What you get

• A page at https://<slug>.sharehtml.org/, one origin per page.
• The exact bytes you sent. No badge, no script, no analytics injected.
• X-Robots-Tag: noindex, nofollow on free pages, so they stay out of search.
• A page that does not expire. Delete it when you want it gone.

Next

API reference, limits, pricing.