Troubleshooting

Common issues and where to look first

Use this page to resolve common problems quickly. Keep fixes high level and avoid posting secrets.

App fails to start

• Verify Node.js 22.x and pnpm are installed.
• Confirm .env is present and populated.
• Reinstall dependencies with pnpm install.

Admin login issues

• Ensure you are visiting /admin on the local or hosted app.
• Confirm your account exists in the Payload admin.

Missing content or media

• Check that the content is published in Payload.
• Verify storage credentials and bucket access in the hosting environment.

Data not updating

• Clear local cache and restart the dev server.
• Confirm the Payload API is reachable from the app.

Payment or email errors

• Confirm Stripe or Resend environment variables are configured.
• Verify the service is enabled for the current environment.