Moving from paid to free add-ins

Starting July 29th, 2019, we no longer accept new paid add-ins to Microsoft AppSource and by February 28, 2020, all paid add-ins in AppSource will be hidden and no longer be available to new customers. Your paid add-ins will remain available to existing subscribers until June 30th, 2020 when we will cancel all paid add-in subscription. Before then, we’re offering code samples and technical guidance to help you convert your paid add-ins to paid SaaS offers and continue selling on AppSource.

If you're interested in engaging with Microsoft for guidance on moving paid add-ins to paid SaaS offers, please contact us.

For details about how to monetize add-ins going forward, see Monetize your Office 365 add-in through Microsoft Commercial Marketplace.

Add-in user experience

The following table describes the add-in user experience for different purchase types, and the action that you can take to transition from paid to free add-ins.

Purchase type New user Existing user Action to take
Subscription The user will receive a free entitlement. The add-in will no longer be available to purchase but can be acquired for free. This will be returned in the token for the add-in entitlement. The user will no longer be charged after their billed month ends. At the end of the period they have paid for, the subscription license will be extended indefinitely.

If the license was previously seat-based (applies to Outlook and SharePoint add-ins only), it will be modified to resemble a site license for the user. This will be returned in the token to the add-in.

All active trial licenses will be converted to free entitlements.
Where a token in a free or extended subscription state is returned, you can take the opportunity to upsell the user to the new license. Some information to inform upsell decisions is maintained in the token.

Token changes
The license tokens will change when an add-in moves from paid to free, as follows:
  • Update to all migrated tokens:
    ed="8999-12-31T23:59:59Z"
  • Update to all seat-based tokens:
    sl="true"
  • For seat-based tokens, where the customer previously purchased a site-license:
    ts="0"
  • For seat-based tokens, where the customer purchased 3 seats:
    ts="3"
One-time purchase The user will receive a free entitlement. The add-in will no longer be available to purchase but can be acquired for free. This will be returned in the token for the add-in entitlement. The user’s original purchase will still be valid. If the license was previously seat based (applies to Outlook and SharePoint add-ins only), it will be modified to resemble a site license for the user. This will be returned in the token to the add-in.

All active trial licenses will be converted to Free entitlements.
For existing users that return a valid paid token, those users should continue to work. If the original token was seat-based (applies to Outlook and SharePoint add-ins only), the new token will contain the originally purchased seat count.

For new users, or users where the original seat count has been exceeded, you can take the opportunity to upsell the user to the new license.

Token changes
For most users, the license token returned to the add-in will not change. The license tokens will change when an add-in moves from paid to free for seat-based tokens:
  • Update to all seat-based tokens:
    sl="true"
  • For seat-based tokens, where the customer previously purchased a site-license:
    ts="0"
  • For seat-based tokens, where the customer purchased 3 seats:
    ts="3"

Examples

Following are a few examples of the experience after an add-in switches from paid to free:

  • Word user, purchased add-in via one-time purchase

    Because this user had purchased the add-in prior to the switch to free, the license token will still return an active paid entitlement for that user in the “et” parameter.

  • Word user, acquires free version of same add-in

    Because this user had not acquired the add-in when it was paid, the license token will return a free entitlement for that user in the “et” parameter.

  • Outlook user, purchases add-in via subscription

    In this case, the user will continue to use the subscription they paid for until the end of that billing period. The expiry date for the subscription will extend and they will no longer be charged for the add-in going forward.

  • Outlook user, acquires free version of same subscription add-in

    The user had not acquired the add-in when it was paid, so the license token will return a free entitlement for that user in the “et” parameter.

  • SharePoint user, purchased seat-based license for 3 seats via one-time purchase

    In this case, the token will effectively come back as a site license but will also include the number of seats that had been purchased.

  • SharePoint user, purchased seat-based license for 3 seats via subscription

    In this case, the token will come back with an expiration date that will be extended indefinitely, and it will come back as a site license but will also include the number of seats that were acquired previously.

  • Excel user, acquired add-in as a trial

    Because this add-in was acquired prior to the trial expiration date, the trial will now return a free entitlement.

    Note: This applies for subscription or one-time purchase add-ins.