Quickstart: publish an entity at your domain

You need a domain you control and a way to serve a static JSON file at a specific path. If you already run a website (WordPress, Ghost, Astro, static HTML), you already have this. The entire setup takes under an hour.

Step 1. Pick your network ID

An OLPN network ID has the form §:entity:{domain}. The domain is whatever you own and plan to serve your entity document from.

Examples:

• §:entity:janedoe.law
• §:entity:smithlawfirm.com
• §:entity:maine-bar.org

Step 2. Write your entity document

Create a JSON file with the minimum viable shape. Only network_id is strictly required; everything else is recommended.

{
  "version": "0.9",
  "last_updated": "2026-04-24T12:00:00Z",
  "entity_type": "person",
  "network_id": "§:entity:janedoe.law",
  "details": {
    "name": "Jane Doe",
    "domain": "janedoe.law",
    "email": "[email protected]",
    "location": "Portland, OR",
    "description": "Plaintiffs' trial lawyer."
  },
  "properties": [],
  "credentials": [],
  "other_connections": []
}

Step 3. Publish it at /olpn.json

Upload the file so that https://{your-domain}/olpn.json returns the JSON above with content-type application/json. The exact method depends on your stack:

• Static host (Netlify, Cloudflare Pages, S3): drop the file into your web root and deploy.
• WordPress: upload via the Media Library's file-type allowlist, or drop into wp-content/uploads/ and configure a rewrite so /olpn.json points at the file.
• Ghost: Ghost does not serve arbitrary paths. Use the HTML-embed fallback instead.
• Server-side app: add a route that returns the JSON.

Step 4. Verify

Search for your network ID at olpn.org/search. If the resolver finds your document, the page will show the profile, an empty properties/credentials list, and a trace of the fetch. That confirms the JSON is reachable and parses.

Next

From here you typically want to:

• Add a property (proves ownership of another site you run)
• Issue credentials to members (if you are an organization)
• Ask a firm, bar, or school that has issued you something to publish their own OLPN identity, so their credentials to you become verifiable.