Create a New Version of a Partner Provisionable Product
This Page
All Documentation
Replace a Partner Provisionable Product (PPP) with a new version to deliver new permission set licenses (PSLs) to customers who have Offers and Orders on the original Product. Customers keep their entitlements, and they receive the new licenses without rebuilding their Offers and Orders.
This feature applies to 2GP managed packages only.
Before You Begin
Set up the GTM app in your Partner Business org (PBO).
Make sure that you’re adding functionality to an existing Product. To sell new PSLs, create a new PPP and sell it through the standard Offer and Order process. New customers who want the expanded Product also purchase it through the standard Offer and Order process.
Make sure that the replacement Product is a superset of the original Product. It includes all the original licenses plus the new PSLs, and it can’t remove any.
Make sure that the replacement Product belongs to the same Partner term set as the original Product. The replacement can’t be the same Product that you’re replacing.
Create the New Version
In the GTM app, click the Provisionable Products tab, and open the Product that you want to replace.
Start the new version in one of these ways:
From the detail page: Open the Product that you want to replace, and then click New Version.
From the list view: Find the Product, click the row action menu next to its Status, and then select New Version.
In the Create a New Version window, search for and select the replacement Product. The list includes only Products in the same Partner term set.
Click Next.
In the Review and confirm window, review the customer impact section, which shows how many customers Salesforce reprovisions onto the replacement Product.
Acknowledge the customer impact by selecting the checkbox.
Click Confirm.
Salesforce reprovisions customers in the background. This process can take a few minutes.
Verify the New Version
Open the original Product. A banner indicates that the Product has been replaced. Click View updated version to open the replacement.
In Product Details, confirm that Status is Deprecated and that the Replaced By and Latest Product Version fields show the replacement Product.
Assign the New Permission Set Licenses
After reprovisioning finishes, subscriber admins assign the new PSLs to users the same way they assign other PSLs. Customers receive the new licenses in the background.