Update existing offers in the commercial marketplace

This article explains how to make updates to existing offers and plans, and also how to remove an offer from the commercial marketplace. You can view your offers in the Commercial Marketplace portal in Partner Center.

Tip

After publishing an offer, the owner of your developer account is notified of the publishing status and required actions through email and the Action Center in Partner Center. For more information about Action Center, see Action Center Overview .

Request access to manage an offer

If you see an offer you need to update but don't have access, contact the publisher owner(s) associated with the offer. On the Marketplace offers page, the owner list for an inaccessible offer is available by selecting Request access in the Status column of the table. A publisher owner can grant you the developer or manager role for the offer by following the instructions to add existing users to their account.

Note

Requesting access to an offer will give you access permissions to all the offers associated with the same publisher.

Update a published offer

Use these steps to update an offer that's been successfully published to Preview or Live state.

  1. Select the name of the offer you would like to update. The status of the offer may be listed as Preview, Live, Publish in progress, Draft, Attention needed, or Not available (if you've previously chosen to stop distribution of the offer). Once selected, the Offer overview page for that offer will open.
  2. Select the offer page you want to update, such as Properties, Offer listing, or Preview (or select Update from the applicable card on the Offer overview page).
  3. Make your changes and select Save draft. Repeat this process until all your changes are complete.
  4. Review your changes on the Compare page.
  5. When you're ready to publish your updated offer, select Review and publish from any page. The Review and publish page will open. On this page you'll see the completion status for the sections of the offer that you updated:
    • Unpublished changes: The section has been updated and is complete. All required data has been provided and there were no errors introduced in the updates.
    • Incomplete: The updates made to the section introduced errors that need to be fixed or requires more information to be provided.
  6. Select Publish to submit the updated offer for publishing. Your offer will then go through the standard validation and publishing steps.

Important

You must review your offer preview once it's available and select Go-live to publish your updated offer to your intended audience (public or private).

Add a plan to an existing offer

Complete these steps to add a new plan to an offer that you've already published.

  1. With the Offer overview page for your existing offer open, go to the Plan overview page, and then select Create new plan.

  2. Create a new plan according to the guidelines by using the existing plans Pricing model.

  3. Select Save draft after you change the plan name.

  4. Select Publish when you're ready to publish your updates. The Review and publish page opens and provides a completion status for your updates.

Update a plan for an existing offer

Complete these steps to make changes to a plan for an offer that you've already published.

  1. With the Offer overview page for your existing offer open, choose the plan that you want to change. If the plan isn't accessible from the Plan overview list, select See all plans.
  2. Select the plan Name, Pricing model, or Availability. Currently, plans are available only in English (United States).
  3. Select Save draft after making any changes to the plan name, description, or audience availability.
  4. Select Review and publish when you're ready to publish your updates. The Review and publish page opens and provides a completion status for your updates.
  5. Select Publish to submit the updated plan for publishing. We'll email you when a preview version of the updated offer is available for you to review and approve.

Note

If you publish a private plan, you can change its visibility to public later. However, once you publish a public plan, you cannot change its visibility to private.

Update image versions for an existing VM offer

Complete these steps to update available images in a plan for an offer that you've already published.

  1. With the Offer overview page for your existing offer open, choose the plan you want to change. If the plan isn't accessible from the Plan overview list, select See all plans.
  2. In the focus nav, select Technical Configuration.
  3. To add a new version, select + Add VM image.
  4. To remove a version, select Deprecate. Note that you can't deprecate the last VM from the plan.
  5. Select Save draft after making your changes.
  6. Select Review and publish when you're ready to publish your updates. The Review and publish page appears and provides a completion status for your updates.
  7. Select Publish to submit the updated plan for publishing. We'll email you when a preview version of the updated offer is available for you to review and approve.

Note

At least one image version is required for a plan. If you want to stop offering the plan, deprecate the plan.

Offer a virtual machine plan at a new price

See Changing prices in active commercial marketplace offers for details and limitations on changing prices in active transactable offers.

To change the price of a plan that is hidden, hide the old plan and create a new one with the updated price.

To hide the plan with the old price:

  1. With the Offer overview page for your existing offer open, choose the plan that you want to change. If the plan isn't accessible from the Plan overview list, select See all plans.
  2. Select the Hide plan checkbox. Save the draft before you continue.

Now create a copy of that plan but with the updated price:

  1. In Partner Center, go back to Plan overview.
  2. Select Create new plan. Enter a Plan ID and a Plan name, then select Create.
  3. To reuse the technical configuration from the plan you've hidden, select the Reuse technical configuration checkbox. Read Create plans for a VM offer to learn more.

    Important

    If you select This plan reuses technical configuration from another plan, you won't be able to stop distribution of the parent plan later. Don't use this option if you want to stop distribution of the parent plan.

  4. Complete all the required sections for the new plan, including the new price.
  5. Select Save draft.
  6. After you've completed all the required sections for the new plan, select Review and publish. This will submit your offer for review and publication. Read Review and publish an offer to the commercial marketplace for more details.

Compare changes to your offer

Before you publish updates to your live or preview offer, you can audit the saved changes in the Compare page. You can access the Compare page in the upper-right corner of any offer page, such as the Properties or Offer listing page. The Compare page shows side-by-side versions of the saved changes of this offer and the published marketplace offer.

  • You can use Compare at any point during the editing process.

  • Select a field on the Compare page to navigate to the value you want to modify.

  • To see the values for all fields, even fields not updated, select the All fields filter. You can modify filters within these fields by selecting Modified fields, then selecting one of the filters below:

    • Removed values filter displays fields that you published and you're now completely removing.

    • Added values filter displays fields that you did not originally publish and are now adding.

    • Edited values filter displays fields that had been published but you've now updated the contents.

      Note

      If one of these filters isn't available, it indicates that you didn't make an update of that type.

  • To see only values that haven't been updated, select the Unchanged fields filter. The field values shown for the published and draft version will be the same.

    Filters for comparing updates to your published or preview offer

Remember to republish your offer after making updates for the changes to take effect.

Compare changes to a preview offer

If you have changes in preview that aren't live, you can compare new changes with the preview marketplace offer.

  1. Select Compare in the command bar of the page.
  2. Select the With dropdown and change it from Live offer to Preview offer. If your offer hasn't gone live yet, you won't see the Live offer option.
  3. The Compare page provides side-by-side versions that show the changes.

Remember to republish your offer after making updates for the changes to take effect.

Stop distribution of an offer or plan

You can remove offer listings and plans from the Microsoft commercial marketplace, which will prevent new customers from finding and purchasing them. Any customers who previously acquired the offer or plan can still use it but they can’t re-download or redeploy. Also, they won't get updates if you decide to republish the offer or plan at a later time.

  • To stop distribution of an offer after you've published it, select Stop distribution from the Offer overview page. Within a few hours of your confirmation, the offer will no longer be visible in the commercial marketplace.

  • To stop distribution of a plan, select Stop distribution from the Plan overview page. The option to stop distribution of a plan is only available if you have more than one plan in the offer. You can choose to stop distribution of one plan without impacting other plans within your offer.

    Note

    Once you confirm you want to stop distribution of the plan, you must republish the offer for the change to take effect.

After you stop distribution of an offer or plan, you'll still see it in Partner Center with a Not available status. If you decide to list or sell this offer or plan again, follow the instructions to update a published offer. Don't forget that you will need to publish the offer or plan again after making any changes.

Remove offers from existing customers

To remove offers from existing customers, log a support request. In the support topic list, select Commercial Marketplace > Offer or App Delisting, Removal, or Termination and submit the request. The support team will guide you through the offer removal process.

When the offer removal is initiated by the publisher, the publisher owns communication of the removal to the customer.

Next steps