Skip to main content

Going to Production

When your pilot is complete and you're ready to issue credentials for real-world use, here's what to check and what changes.

Production Checklist​

Before switching to production mode, ensure:

  • DID is configured — Already proven and tested during your pilot. No changes needed.
  • Facility records created — All relevant facilities have DFRs
  • Credential content finalized — You've iterated on your credential structure in pilot mode and are satisfied with the content
  • Team access configured — All team members have appropriate access levels
  • Identifiers planned — Decide whether to use auto-generated identifiers or bring your own GS1-assigned GTINs/GLNs
  • Evidence files ready — Any PDFs, photos, or documents to attach to credentials are uploaded

What Changes in Production​

From your perspective, the main visible change is that the Pilot Mode banner is removed — the interface looks clean and production-ready.

ID Resolver Entries (DPPs only)​

In pilot mode, re-issuing a DPP overwrites the existing resolver entry. In production mode, when the claims on a DPP change, best practice is to issue a brand new DPP with a new ID Resolver entry rather than overwriting the original. Whether this is enforced or left as guidance is still on the roadmap.

DFRs work differently. A facility's resolver entry always accumulates — every time the claims on a DFR change, the new signed JSON is added to the same resolver path. The resolver collects as many versions as there are changes to the facility's claims.

Domain and Branding​

For production deployment:

  • Custom domain — Your DID will use your production domain (e.g., did:web:credentials.acme.com:org:acme)
  • HTTPS required — did:web requires HTTPS for DID Document resolution
  • DNS configuration — Point your domain to the DPP Kit infrastructure

Data Migration​

Pilot credentials can coexist with production credentials. You don't need to delete pilot data — it's tagged with issued_in_mode: pilot so it's clearly distinguishable.

When you're ready:

  1. Upgrade your organization tier to Production
  2. Switch the organization mode to Production
  3. Begin issuing production credentials
tip

Consider running a brief parallel period where you issue both pilot and production credentials to validate the transition before fully committing.