Everything in Display.dev is one of a small set of nouns. The rest of the docs assume you know these.
Artifact
An artifact is a single piece of authored content — an HTML file, a Markdown document, an exported notebook — that has been published to Display.dev. Each artifact has:
- A shortId — the stable handle (
abc123) that appears in every URL and CLI command for the artifact. - A slug — the human-friendly name segment derived from the artifact name.
- A version (see below).
Version
Every republish bumps the artifact's version by one — v1 on first publish, v2 after the next dsp publish --id <shortId> ..., and so on. The artifact's URL always serves the latest version by default; readers don't have to know what version they're looking at.
A specific version can be linked directly with the /_v/<n> path suffix — for example, https://acme.dsp.so/abc123-quarterly-report/_v/2. The CLI's dsp export <shortId>@2 does the same thing for source bytes.
Version retention depends on plan. Free orgs keep only the latest version on every artifact; paid plans keep older versions up to a per-tier cap. See Plans & features.
Organization
An organization is the unit of billing, identity, and access. Members of an organization can see each other's artifacts (subject to visibility) and bill against the same plan.
Visibility
Every artifact has a visibility setting:
- Public — anyone with the link can view, no auth required.
- Company — anyone signed in to your organization can view.
- Private — only the publisher and explicit allowlisted addresses (
sharedWith).
Visibility & sharing covers the full semantics including external-guest invitations and tier requirements.
Organization subdomain
Each organization gets a stable view subdomain — <org>.dsp.so — so artifacts always render at the same hostname for a given organization. This lets your company set up bookmarks, browser policies, and SSO trust against one origin.