Try Serpent Free
← Salesforce DevOps Glossary

1GP (First-Generation Packaging)

Salesforce's original way to build packages, made by uploading straight from an org instead of code in Git.

Definition

1GP (first-generation packaging) is Salesforce's original packaging model, where a managed or unmanaged package is built directly inside a namespaced org by clicking "Upload" in Setup, rather than from source in version control. Metadata lives in the packaging org itself, not in Git, so tracking history, running CI, or reviewing a diff before release all require tooling layered on top.

1GP packages don't support formal dependency declarations between packages the way 2GP does, and each org can register and hold exactly one namespace, so scaling to multiple products means multiple packaging orgs.

Salesforce still supports 1GP for existing packages and continued releases, but recommends 2GP for all new development because it's source-driven, versioned properly, and CI-friendly. Most 1GP-to-2GP migrations happen once a team's release cadence outgrows what a single packaging org and manual uploads can support.

In practice

How it works in Serpent

Serpent supports native 1GP alongside 2GP so ISVs and PDOs with an existing namespaced packaging org aren't forced into a disruptive migration before adopting real DevOps practices. Metadata changes still flow through Serpent's task-based tracking and release pipeline, giving 1GP teams version history, preflight checks, and rollback they wouldn't otherwise have. See package development in Serpent for how both models are handled.

Commit-to-package mapping in Serpent
Common questions

1GP, answered

Is 1GP still supported by Salesforce?
Yes. Existing 1GP packages continue to work and can still ship new versions, but Salesforce recommends building all new packages on 2GP instead.
Can I convert a 1GP managed package to 2GP?
Yes, but it requires requesting conversion access for your namespace from Salesforce first, and the conversion is a one-time, non-reversible step.
Does 1GP support unlocked packages?
No. Unlocked packages are a 2GP-only package type; 1GP only produces managed or unmanaged packages.

Start free. No credit card, no install, no commitment.

Set up in under 15 minutes. No DevOps hire needed.

Curious about faster shipping before you dive in? Let's talk

Commitment free!