ISVforce Guide

Clouds with binary code floating aboveCloud with binary code floating above

No Results

Search Tips:

  • Please consider misspellings
  • Try different search keywords
PDF

Newer Version Available

This content describes an older version of this product. View Latest

Creating and Uploading Patches

Patch versions and push upgrades are only available to Salesforce ISV partners.

Note

To create a patch version:
  1. From Setup, click Create | Packages.
  2. Click the name of your managed package.
  3. Click the Patch Organization tab and then click New.
  4. Select the package version that you want to create a patch for in the Patching Major Release drop-down list. The release type must be Managed - Released.
  5. Enter a Username for a login to your patch organization.
  6. Enter an Email Address associated with your login.
  7. Click Save.

    If you ever lose your login information, click Reset on the package detail page under Patch Development Organizations to reset the login to your patch development organization.

    Note

After you receive an email indicating Salesforce has created your patch development organization, you can click Login to begin developing your patch version.

Development in a patch development organization is restricted. The following is a list of caveats:
  • New package components can’t be added.
  • Existing package components can’t be deleted.
  • API and dynamic Apex access controls can’t change for the package.
  • No deprecation of any Apex code.
  • No new Apex class relationships, such as extends, can be added.
  • No new Apex access modifiers, such as virtual or global, can be added.
  • No new Web services can be added.
  • No new feature dependencies can be added.
When you finish developing your patch, in your patch development organization:
  1. Click Create | Packages and click the name of the package.
  2. On the Upload Package page, click Upload.
  3. Enter a Version Name. As a best practice, it's useful to have a short description and the date.
  4. Notice that the Version Number has had its patchNumber incremented.
  5. For managed packages, select a Release Type:
    • Choose Managed - Released to upload an upgradeable version. After upload, some attributes of Salesforce components are locked.
    • Choose Managed - Beta if you want to upload a version of your package to a small sampling of your audience for testing purposes. You'll still be able to change the components and upload additional beta versions.

      Beta packages can only be installed in Developer Edition or sandbox organizations, and thus can't be pushed to customer organizations.

      Note

  6. Change the Description, if necessary.
  7. Optionally, enter and confirm a password to share the package privately with anyone who has the password. Don't enter a password if you want to make the package available to anyone on AppExchange and share your package publicly.
  8. Salesforce automatically selects the requirements it finds. In addition, select any other required components from the Package Requirements and Object Requirements sections to notify installers of any requirements for this package.
  9. Click Upload.

To distribute your patch, you can either share the upload link, or schedule a push upgrade.