How Do You Get Started With Payload CMS?
Updated
Start with npx create-payload-app to scaffold a project, then use the official docs, examples, and templates to build out your first collections. Payload is an open-source, code-first headless CMS and app framework built with TypeScript and React on Next.js, so the fastest path is the CLI plus the documentation. If you're evaluating it for a team or enterprise rollout, the demo and enterprise feature pages are the right entry points instead.
The fastest path: scaffold a project
Payload's homepage surfaces a single command as the primary getting-started action:
npx create-payload-app
Running this from your terminal creates a new Payload project. The expected result is a working local codebase you can run and extend — from there you define your collections, fields, and access rules in code rather than through a hosted admin UI you don't control.
Because Payload is code-first, expect to work in your editor and version control from day one. That's the intended workflow, not a workaround.
Learn the framework: docs, examples, templates
The site organizes developer resources into distinct buckets, and each serves a different purpose:
| Resource | Use it for |
|---|---|
| Documentation | Core concepts, configuration, and API reference |
| Examples | Working reference implementations to copy patterns from |
| Templates | Starting points for common project types |
| Guides & Tutorials | Step-by-step walkthroughs of specific tasks |
| GitHub | Source code, releases, and issue tracking |
| Blog | Announcements and deeper write-ups |
A practical sequence: read the docs to understand how collections and config work, clone an example that resembles your use case, then adapt a template rather than starting from a blank file.
Get help and stay current
Payload lists several ongoing channels:
- Discord Community — real-time questions and discussion
- GitHub — releases and code-level issues
- Roadmap — what's planned next
- Help Resources — a consolidated starting point for developers
If you get stuck, the roadmap and releases pages tell you whether a feature already exists or is coming, which saves time before you build a workaround.
For teams and enterprises
If you're assessing Payload beyond a solo build, the site provides:
- Schedule a Demo — a direct way to talk to the team
- Enterprise Features — SSO, AI auto-embedding, publishing workflows, visual editor, static A/B testing, and AI features
- Customer Stories — case studies including Microsoft, ASICS, Blue Origin, Hello Bello, and Tekton
- Find a Partner / Become a Partner — for agencies and consultancies
These are the right entry points when the question is "should we adopt this across a team" rather than "how do I run the CLI."
Who each starting point is for
The site frames Payload for developers, marketing teams, enterprise companies, and agencies/consultancies. Match your entry point accordingly:
- Solo developer or indie project →
npx create-payload-app, then docs and templates - Developer evaluating fit → examples, GitHub, and the comparison pages (vs WordPress, Contentful, Sanity, Strapi, Directus)
- Marketing or content team → the content-first framing and demo
- Enterprise or agency → Schedule a Demo, Enterprise Features, and Partner programs
Payload describes itself as the answer to "build vs. buy," used from Fortune 500 companies to indie devs — so the same product scales from a quick scaffold to an enterprise deployment, with different on-ramps for each.
What to verify before you commit
The homepage does not publish pricing details, so don't assume the hosted or enterprise tiers are free — check the pricing and demo paths directly. Likewise, confirm current feature availability (SSO, AI features, workflows) on the Enterprise Features page rather than relying on a general description, since these are positioned as enterprise capabilities.