How to: Submit apps for SharePoint to the Microsoft Seller Dashboard

apps for Office and SharePoint

Developers can use the Microsoft Seller Dashboard to submit apps for SharePoint to the Office Store. Learn how to submit your apps for approval and inclusion in the Office Store.

Last modified: April 15, 2014

Applies to: Office 2013 | Office 365 | SharePoint Foundation 2013 | SharePoint Server 2013

You need to have the prerequisites, app and other information ready before you can add/submit apps to the Seller Dashboard for approval and inclusion in the Office Store. To learn about the prerequisites, app and other information you need to have ready, see Checklist for submitting an app to the Microsoft Seller Dashboard.

Note Note

This article relates specifically to apps for SharePoint. For information about submitting apps for Office to the Office store, see How to: Submit apps for Office to the Microsoft Seller Dashboard.

You can add and save your app as a draft in your Seller Dashboard account. This is available even while your account is pending approval, if you don’t have all the information you need, or to begin the process of adding an app but don’t want to submit it for approval yet.

Note Note

If your app requires an Open Authorization (OAuth) client ID and client secret, you can add a client ID and client secret in the Seller Dashboard before adding your app. For more information, see How to: Create or update client IDs and secrets in the Microsoft Seller Dashboard.

To add an app and save it as a draft

  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 Office Types that matches your app.

  4. If it’s the first time you are creating an app for the store that lists your app type, an agreement will appear. 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 at a later date that will be listed in a different store, you will see a different store agreement. If you add an app at a later date that will be listed in the same store, the same agreement applies. If you agree, you will only see the agreement for that store 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, 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, do the following:

    • Under general info, provide the information, which can include App Title, Version, and Release Date, depending on your app type.

      Important note Important

      The number you provide for the Version must exactly match the version number in the app manifest file of the app you submit. Release Date is the date you want displayed as the date your app is released.

    • 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.

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

      Note Note

      For an app for SharePoint, there is only one logo associated with your app. If your logo requires localization, you will need to submit your localized apps separately with separate logos in each language.

    • Under app package do the following:

    • Choose the app package tile, and upload your app.

      Important note Important

      To submit an app for SharePoint that uses OAuth and you wish to distribute it to China, you must:

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

      • add a separate app package specifically for China.

      • block access for all countries except China.

      • create a separate app listing for China.

      For more information, see Submitting apps for SharePoint (China).

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

      Important note Important

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

    • Under Testing Notes, provide instructions and links to resources that will help validation testers validate your app as part of the app approval process. For example, provide valid credentials or a password if your app requires them. The credentials or password are not for public use and will only be used by Microsoft. Your Testing Notes are solely 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 app.

      If your app 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.

    • Under support documents, provide a link to your support documentation for your app. 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 for your app.

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

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

    Note Note

    You must repeat the following steps for each language that your app has been localized to and supports.

    1. In the Choose Language drop-down list, choose the language that your app has been localized to and supports.

      Note Note

      Only choose a language that your app has been localized to and supports.

    2. Choose the language for your app details, and then click CONFIRM.

    3. 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.

    4. Under screenshots, choose Primary tile to upload at least one screen shot of your app. You can upload up to five images.

      Important note Important
      • Customers will see your screen shots in the store listing for your app, so do not include any private or personal information that you do not want customers to see.

      • You can add language-specific screen shots to match each language. Screenshots that match each language provides the best customer experience.

    Note Note
    • To add another language, choose ADD A LANGUAGE and repeat the previous three steps for each language that your app has been localized to and supports.

    • 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 apps listed and sold, if any. If there are countries/regions you want to block customers from purchasing the app, do the following:

    Important note Important

    To submit an app for SharePoint that uses OAuth and you wish to distribute it to China, you must block access for all countries except China. You also must:

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

    • add a separate app package specifically for China.

    • create a separate app listing for China.

    For more information, see Submitting apps for SharePoint (China).

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

    • Choose the SELECT COUNTRIES/REGIONS button.

      • 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.

      • 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.

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

  11. On the pricing page, specify the pricing of your app.

    Note Note

    If your app cannot be offered for purchase, you may not see the pricing page.

    To list your app for purchase, you must also provide payout and tax information. For more information, see How to: Create or edit a seller account and add payout information and Checklist for creating a seller account and adding payout information.

    You can also add pricing information later. Choose SAVE AS DRAFT and come back later to finish adding your pricing information.

    Choose the price for your app:

    • If your app is free, leave This app is free selected.

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

    • To offer your app as a monthly, auto-renewing subscription, choose This app is will be sold as a subscription, and select the Price Per User.

      App price is set at the app level. You don’t set a price for each language. You set a price tier.

      Note Note

      You can’t change the pricing on an app from subscription to one-time charge, or vice versa, once you have submitted the app listing. This includes apps you may have submitted before the subscription pricing option was available.

    For paid or subscriptions apps, choose if you want to offer your app as a trial. To offer a trial of your app, under trial support, select the My app supports a trial check box, and select the duration in the Duration of Trial drop-down field.

    Information specific to apps for SharePoint

    For apps for SharePoint, you can also set two additional pricing options for paid or subscription apps:

    • Number of trial users

      This setting limits the total number of users on a given site who can use the app as a trial.

      To do so, select the number of users in the Number of Users in Trial drop-down field.

    • Price threshold

      This sets a limit on the amount a single buyer pays for purchasing multiple app licenses. For example, if you set the price threshold at ten users, then the user would only get charged for the first ten licenses they purchase; any licenses they purchase after that are free of charge.

      To place a limit on the maximum a buyer pays, choose a Price Threshold. If you choose No threshold, then the buyer pays the Price Per User for each user no matter the number.

    These setting do not apply to apps for Office.

    For more information and a complete discussion of your pricing options for apps, see Decide on a pricing model for your app for Office or SharePoint.

  12. Choose SAVE AS DRAFT or cancel.

To submit an app for approval

After your account in the Seller Dashboard is approved, you can submit apps for approval. To submit an app for purchase, your payout and tax information must also be validated before you can submit an app for approval. See How to: Create or edit a seller account and add payout information if you have not yet added this information in the Seller Dashboard. Your approved apps will be listed in product-specific stores.

To submit an app for approval, do the following:

  • If your account is approved and you are adding a new app, follow the steps in the previous section to add an app. In the final step of that procedure, click SUBMIT FOR APPROVAL instead of SAVE AS DRAFT.

  • If you are submitting an app that you saved to the Seller Dashboard as a draft, and you want to make changes before submitting it, choose the apps tab, and then choose the app you want to edit and submit. On your app summary page, choose EDIT DRAFT and make your changes. Choose SUBMIT FOR APPROVAL.

  • To submit an app that you saved to the Seller Dashboard as a draft without making changes, choose the apps tab, and then choose the app you want to submit. On your app summary page, choose SUBMIT FOR APPROVAL.

    Note Note

    After you submit an app for approval, no changes can be made to your app during the approval process. When the approval process is complete, you will receive an email message. You can then edit or update your app, if necessary. For more information, see the Edit your app section in How to: Update, unpublish, and track your app metrics.

You can submit apps for approval after your account is approved. You can make changes to your app at any point before you submit it for approval. During the approval process, you won’t be able to make changes to your app. If you make changes to an approved app, it must go through the approval process again.

Some of the requirements for approval are:

  • Your app must be free of viruses. If you need virus detection software, see the Microsoft Safety & Security Center.

  • Your app must not contain inadmissible or offensive material.

  • Your app must be stable and functional.

  • Any material that you associate with your app, such as descriptions and support documentation, must be accurate. Use correct spelling, capitalization, punctuation, and grammar in your descriptions and materials.

  • If you want a tailored experience for users in regional store, you can add additional languages so your app appears in other language store with localized metadata. Your service and your app manifest must be appropriately updated, if applicable. You must also provide app descriptions for each language you add.

Note Note

For more information about validation policies, see Validation policies for the apps submitted to the Office Store (version 1.5).

You will receive a message when validation process is complete, alerting you that your app is approved or your app requires changes and resubmission. You can also follow these steps to check the status in the Seller Dashboard:

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

  2. On the APPS tab, under manage, your app status appears under the app name.

    • If the status is pending approval, your app is still being verified. When in this state, you can’t update or resubmit your app.

    • If the status is approved, your app is approved to be listed in the appropriate marketplaces.

      Note Note

      Once your app is approved in the Seller Dashboard, there may be a delay before it is published in a store. After approval, an app typically appears in the store within 24 hours. If you’ve questions or issues with the approval process, see Support Resources.

    • If the status is changes requested, your app needs changes in order to be approved. Click the app, and then on the app summary page, click View the app report for details about the required changes.

Show:
© 2014 Microsoft