Version
In Salesforce managed packages and metadata, a numbered iteration of a component or package (like API version 59.0 or package version 1.5) that identifies a specific release with its capabilities a…
Definition
In Salesforce managed packages and metadata, a numbered iteration of a component or package (like API version 59.0 or package version 1.5) that identifies a specific release with its capabilities and changes.
In plain English
“A Version in Salesforce refers to a numbered iteration of a component or package, like API version 59.0 or package version 1.5. Versions identify specific releases and determine which features and behaviors are available.”
Worked example
Cottonmoor Software ships a managed package on AppExchange with releases versioned 2.4, 2.5, and 2.6 - each a Version of the package with specific components and capabilities. Apex classes within the package have their own Version (the API Version they target - 56.0, 60.0). When customers install Version 2.6, they get all the components of that release; their existing Version 2.4 components upgrade in place where compatible. Version is the identification primitive for tracking what's deployed, what's available, and how things compare across releases - at both the package and metadata-component level.
Why Version matters
In Salesforce managed packages and metadata, a Version is a numbered iteration of a component or package (like API version 59.0 or package version 1.5) that identifies a specific release with its features, fixes, and behaviors. Versioning enables backward compatibility and controlled evolution.
Versioning is foundational to platform stability. API versioning ensures code compiled against older versions continues to work. Package versioning lets ISVs release new functionality while maintaining older versions. Mature development practices are versioning-aware.
How organizations use Version
Manages package versions carefully for their ISV products.
Keeps code on current API versions for access to new features.
Treats versioning as foundational platform knowledge.
🧠 Test your knowledge
Q1. What is a Version?
Q2. Why does versioning matter?
Q3. What examples exist?

Discussion
Loading discussion…