You are here:
Manage Version Settings for Visualforce Pages and Custom Components
Visualforce pages and custom components have version settings for the API and Visualforce. Managed packages referenced by the page or component also have their own version settings. Package versions can be used to evolve components without breaking existing customer integrations using the package.
Required Editions
| Available in: Salesforce Classic and Lightning Experience |
| Available in: Contact Manager, Group, Professional, Enterprise, Performance, Unlimited, and Developer Editions |
| User Permissions Needed | |
|---|---|
| To create, edit, and set version settings for Visualforce pages: | Customize Application |
To aid backwards-compatibility, each Visualforce page and custom component is saved with version settings for the specified version of the API as well as the specific version of Visualforce. If the Visualforce page or component references installed managed packages, the version settings for each managed package referenced by the page or component is saved too. This ensures that as Visualforce, the API, and the components in managed packages evolve in subsequent versions, Visualforce pages and components are still bound to versions with specific, known behavior.
A package version is a number that identifies the set of components uploaded in a package. The version number has the format majorNumber.minorNumber.patchNumber (for example, 2.1.3). The major and minor numbers increase to a chosen value during every major release. The patchNumber is generated and updated only for a patch release. Publishers can use package versions to evolve the components in their managed packages gracefully by releasing subsequent package versions without breaking existing customer integrations using the package.
To set the Salesforce API and Visualforce version for a Visualforce page or custom component:
-
Edit a Visualforce page or component and click Version
Settings.
You can only modify the version settings for a page or custom component on the Version Settings tab when editing the page or component in Setup.
- Select the Version of the Salesforce API. This is also the version of Visualforce used with the page or component.
- Click Save.
Configure the Package Version Settings
- Edit a Visualforce page or component and click Version Settings.
- Select a Version for each managed package referenced by the Visualforce page or component. This version of the managed package will continue to be used by the page or component if later versions of the managed package are installed, unless you manually update the version setting. To add an installed managed package to the settings list, select a package from the list of available packages. The list is only displayed if you have an installed managed package that isn’t already associated with the page or component.
- Click Save.
Note the following when working with package version settings:
- If you save a Visualforce page or custom component that references a managed package without specifying a version of the managed package, the page or component is associated with the latest installed version of the managed package by default.
- You can’t Remove a Visualforce page or component’s version setting for a managed package if the package is referenced by the page or component. Use Show Dependencies to find where the managed package is referenced.
- Package subscribers can use package versions to reference deleted components. Visualforce pages within a package always use their own package's latest API version. They cannot access deleted components.
