Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

Submit Office and SharePoint Add-ins and Office 365 web apps to the Seller Dashboard

Office and SharePoint Add-ins

Use the Seller Dashboard to submit Office Add-ins, SharePoint Add-ins, and Office 365 web apps using Azure AD to the Office Store.

Last modified: July 21, 2015

Applies to: apps for Office | apps for Office Mix | apps for SharePoint | Office 365 | Office Add-ins | SharePoint Add-ins

Note Note

The names "apps for Office" and "apps for SharePoint" are changing to "Office Add-ins" and "SharePoint Add-ins". During the transition, the documentation and the UI of some Office and SharePoint products and Visual Studio tools might still use the terms "apps for Office" and "apps for SharePoint". For details, see New name for apps for Office and SharePoint.

In this article
Submit an app or add-in and save it as a draft
Submit an app or add-in for approval
Additional resources

If you want your app or add-in to appear in the Office Store, you need to submit it to the Seller Dashboard for approval. First, prepare the information listed in Checklist for submitting apps and add-ins to the Seller Dashboard, and familiarize yourself with the Office Store validation policies. You can add and save your app or add-in as a draft in your Seller Dashboard account until you're ready to submit it for approval.

If your SharePoint Add-in requires an Open Authorization (OAuth) client ID and client secret, you can add a client ID and client secret in the Seller Dashboard before you add your add-in. For more information, see Create or update client IDs and secrets in the Seller Dashboard.

If you're submitting Office 365 web apps to the Seller Dashboard, make sure that you have registered your web app with Azure Active Directory. The Office Store currently accepts only Azure AD apps that use OAuth 2.0 and OpenID Connect as their authentication method.

For information about the Office Store approval process, see Upload Office and SharePoint Add-ins and Office 365 web apps to the Office Store.

  1. Sign in to the Seller Dashboard with your Microsoft account.

  2. On the APPS tab, choose add a new app.

  3. In the NEW APP wizard, on the listing type page, choose the item in Office Types that matches your submission.

  4. If you are creating an app or add-in for the store for the first time, an agreement appears. Under marketplace terms and conditions, read the agreement, and if you agree, select the check box, and then choose NEXT or cancel.

    Note Note

    If you add an app or add-in at a later date that will be listed in a different store, you will see a different store agreement. If you add an app or add-in at a later date that will be listed in the same store, the same agreement applies. If you agree, you will see the agreement for that store only once. However, if an updated version of the agreement becomes available, you will see the updated version that requires agreement.

    After you add your app or add-in, to see a list of accepted agreements, choose the ACCOUNT tab. On the manage tab, under terms and conditions, you will see the list of the agreements you have accepted. To see the details of an agreement, choose the name of the agreement.

  5. On the overview page:

    • Under general info, provide the required information, which can include App Title, Version, and Release Date, depending on the type of app or add-in you are submitting.

      Important note Important

      For Office and SharePoint Add-ins, the number you provide for Version must exactly match the version number in the manifest file that you submit.

      Release Date is the date you want to be displayed as the date your app or add-in is released.

      Important note Important

      If you are submitting an update and you select a release date that is in the future, your app or add-in will not be discoverable in the Office Store until the date you select. If your app or add-in was available in the Office Store, it will be hidden from users until the release date for the updated version.

    • Choose at least one Category. You can choose up to three categories that will help customers filter in the Office Store to find your app.

      If you choose the Education category for your app or add-in, you'll need to comply with policy 7.17 of the validation policies.

    • Under logo, choose the App Logo tile, and upload your logo file.

      Note Note

      For Office Add-ins, one logo is associated with your add-in. If your logo requires localization, submit your localized add-ins separately with separate logos in each language.

    • Do one of the following, depending on the type of your submission:

      • For Office Add-ins - Under app package, choose the app package tile, and upload the manifest file for your add-in.

      • For SharePoint Add-ins - Under app package, choose the app package tile, and upload your add-in.

        Important note Important

        To submit a SharePoint Add-in that uses OAuth that you want to distribute it to China:

        • Use a separate client ID and client secret for China.

        • Add a separate add-in package specifically for China.

        • Block access for all countries except China.

        • Breate a separate add-in listing for China.

        For more information, see Submit apps for Office 365 operated by 21Vianet in China.

        If your app uses OAuth, select the My app is a service and requires server to server authorization option check box. The OAuth Client ID drop-down field appears. Select the OAuth client ID that you want your add-in to use.

        Important note Important

        If you are submitting a app for SharePoint that uses OAuth and you want to distribute it to China, you must use a separate client ID and client secret for China:

      • For web apps - Under app registration:

        • Provide an Azure app ID. When you register your web app with Microsoft Azure Active Directory, an Azure app ID in the form of a GUID is created.

        • Choose the Azure AD instance that your app uses. The following are the options:

          • Azure Active Directory Global - Use for most Office 365 web apps.

          • Azure Active Directory China - Use for web apps created with Office 365 in China.

          • Microsoft account - Not currently available.

          • Microsoft account + Azure Active Directory Global - Not currently available.

    • Under Testing Notes, provide instructions, links to resources, or a video demonstrating the app or add-in that will help validation testers validate your submission as part of the approval process. For example, provide valid credentials or a password if required. The credentials or password are not for public use and will only be used by Microsoft. Your Testing Notes are for validation purposes and will not be published in your store listing. If you provide complete Testing Notes, they can assist with the approval of your submission.

      For web apps, use the testing notes to supply the Single Sing-On URL to help the validator find the app.

      For apps or add-ins using the Education category, provide subject and age range details. For more information, see policy 7.17 of the validation policies.

    • If your app or add-in calls, supports, contains, or uses cryptography or encryption, select the My app calls, supports, contains, or uses cryptography or encryption. check box. Verify the information, and then choose Yes or No.

      For more information about encryption, see EAR Controls for Items That Use Encryption.

    • If your add-in is iOS compatible, select the Make this add-in available in the Office Add-in Catalog on iPad check box. Provide your Apple developer ID in the Apple ID box.

      Add-ins that are iOS compatible must adhere to additional validation requirements. For more information, see Validation policies for apps and add-ins submitted to the Office Store (version 1.8)

    • Under support documents, provide a link to a website where you provide support documentation. Include http:// or https:// in your URL. Optionally, you can provide a Privacy Document Link, a Video Link, and a customized End-User License Agreement. If you don’t have a customized license agreement, the store will provide one.

  6. Choose NEXT, SAVE AS DRAFT, or cancel.

  7. On the details page, do the following for language selection:

    Note Note

    Repeat the following steps for each language.

    1. In the Choose Language drop-down list, choose the language that your app or add-in supports, and choose CONFIRM.

    2. Under description, provide your App Name, Short Description, and Long Description in the appropriate language. For example, if you chose English in the previous step, type your App Name, Short Description, and Long Description in English.

    3. Under screenshots, choose Primary to upload at least one screenshot. You can upload up to five images. Each screenshot must have file extension .png, jpg, .jpeg, or .gif, must be exactly 512 pixels wide and 384 pixels high, and be no larger than 300 KB.

      Important note Important
      • Customers will see your screenshots in the store listing. Do not include any private or personal information that you do not want customers to see.

      • You can add language-specific screenshots to match each language. Adding screenshots that match each language provides the best customer experience.

    Note Note

    To add or remove a language:

    • To add another language, choose ADD A LANGUAGE and repeat the previous three steps for each language.

    • To remove a language that you’ve added, choose remove language.

  8. Choose NEXT, SAVE AS DRAFT, or cancel.

  9. On the Block Access page, choose the countries/regions where you do not want your app or add-in listed and sold, if any.

    Note Note

    To submit a SharePoint Add-in that uses OAuth and that you want to distribute to China, you must block access for all countries except China.

    • Select the Block customers in certain countries/regions from purchasing this app check box.

    • Choose SELECT COUNTRIES/REGIONS.

      • In the Select which countries/regions you would like to block dialog box, choose the countries/regions you want to block from purchasing your app or add-in.

      • Choose BLOCK COUNTRIES/REGIONS or Cancel after making your selections. If you block a particular country/region, users in that region will not be able to acquire or use your app or add-in.

  10. Choose NEXT, SAVE AS DRAFT, or cancel.

  11. On the pricing page, specify the pricing of your add-in. If you're submitting a web app, leave the default This app is free value selected (web apps are always free).

    Note Note

    If you don't see the pricing page, your add-in cannot be offered for purchase.

    To list your add-in for purchase, you must also provide payout and tax information. For more information, see Create or edit a Seller Dashboard seller account and add payout information.

    Choose one of the following:

    • This app is free (default).

    • This app is for one-time purchase, and select the Price Per User.

    • This app is will be sold as a subscription, and select the Price Per User.

      The price is set at the add-in level. You don’t set a price for each language. You set a price tier.

      Note Note

      After you submit the listing, you can’t change the pricing from subscription to one-time charge or vice versa. This includes submissions you made before the subscription pricing option was available.

    For paid or subscription add-ins, choose whether you want to offer it as a trial. To offer a trial:

    1. Under trial support, select the My app supports a trial check box.

    2. In the Duration of Trial drop-down list, select the duration of the trial.

    3. In the Number of Users in Trial drop-down list, specify the number of trial users you want to allow.

    You can also choose SAVE AS DRAFT and add your pricing information later. For more information, see Decide on a pricing model for your Office or SharePoint Add-in or Office 365 web app.

  12. Choose SAVE AS DRAFT or cancel.

After your account in the Seller Dashboard is approved, you can submit your app or add-in for approval. To submit an app or add-in for purchase, your payout and tax information must also be validated; for more information, see Create or edit a Seller Dashboard seller account and add payout information. Your approved apps and add-ins will be listed in product-specific stores.

To submit a new app or add-in that you have added

  1. Follow the steps in the previous section.

  2. In the final step of the procedure, choose SUBMIT FOR APPROVAL instead of SAVE AS DRAFT.

To submit an app or add-in that you saved to the Seller Dashboard as a draft and need to edit

  1. Choose the apps tab, and then choose the app or add-in you want to edit and submit.

  2. On your summary page, choose EDIT DRAFT and make your changes. Choose SUBMIT FOR APPROVAL.

To submit an app or add-in that you saved to the Seller Dashboard as a draft

  1. Choose the apps tab, and then choose the entry that you want to submit.

  2. On your summary page, choose SUBMIT FOR APPROVAL.

Note Note

After you submit an app or add-in for approval, you cannot make changes to it during the approval process. When the approval process is complete, you will receive an email message. You can then edit or update your app or add-in, if necessary. For more information, see Update your app or add-in in Update, unpublish, and view app and add-in metrics in the Seller Dashboard.

Show:
© 2015 Microsoft