Export (0) Print
Expand All

Add Apps in the Microsoft Seller Dashboard

Published: March 27, 2014

noteNote
This topic applies to the following marketplaces: Office Store and Microsoft Azure Marketplace.

The Microsoft Seller Dashboard allows software developers to submit and distribute their apps that support or enhance Microsoft technologies, such as Microsoft SharePoint, Microsoft Office, and Azure. Your approved apps will be listed in product-specific marketplaces, presenting your offerings to many potential customers.

noteNote
This topic is about submitting apps you have already built. If you need help with building your apps, see the following:

In this topic

Prerequisites for adding apps in the Seller Dashboard

Before you submit apps in the Seller Dashboard, verify the following:

Prepare your app information

Before you add apps in the Seller Dashboard, prepare the information in the following checklist:

 

What you need For these app types Notes Ready

App type

  • All

The app type indicates the Microsoft technology that your app supports or enhances, for example, app for SharePoint.

Check box

App title

  • All

Your App Title appears in the marketplace listing for your app. A shorter title displays well on web pages, so we recommend that your App Title is no more than 15 characters. The title can be up to 50 characters.

TipTip
If you are adding apps for Office or SharePoint, the App Title appears on the overview page of the app wizard in the Seller Dashboard, whereas the App Name appears on the details page.

Check box

App name

  • App for Office

  • App for SharePoint

If you want to offer your apps for Office or SharePoint in multiple languages, you can provide an App Name in each language.

TipTip
The App Name appears on the details page of the app wizard for each language in the Seller Dashboard.

Version

  • App for Office

  • App for SharePoint

ImportantImportant
The version number that you provide must exactly match the version number in the app package you submit.

Check box

Release date

  • App for Office

  • App for SharePoint

The Release Date you enter in the Seller Dashboard does not determine the date on which your app is published in the Office Store. The release date shown in the Office Store is the date that your app first appears in the Office Store.

Check box

Category

  • All

Choose at least one category. You can choose up to three categories that will help customers filter in the marketplace to find your app.

Check box

App logo

  • All

This is an image that you want customers to associate with your app. This app logo image will appear in the marketplace listing for your app.

TipTip
  • Your logo image must be in one of the following file formats: .png, .jpg, .jpeg, or .gif. It must be exactly 96 x 96 pixels and no greater than 250 KB.

  • We recommend that you scan your logo with a current version of virus detection software, and upload it to the Seller Dashboard only if it passes the virus scan. If you need virus detection software, see the Microsoft Safety & Security Center.

  • For apps for Office and 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.

Check box

App package

  • App for Office

  • App for SharePoint

This is your app binary or manifest that you upload to the Seller Dashboard.

TipTip
  • You may or may not see this, depending upon your app type.

  • If you have an app for SharePoint, the extension must be .app. If you have an app for Office, the extension must be .xml (app manifest file).

  • We recommend that you scan your app with a current version of virus detection software, and upload it to the Seller Dashboard only if it passes the virus scan. If you need virus detection software, see the Microsoft Safety & Security Center.

  • If you are submitting apps for Office or SharePoint, and your app supports multiple languages, you will need localized metadata for each language. Apps with web services and functionality that support these additional languages provide the best customer experience.

    For information about localizing apps for Office, see Designing an app for Office for specific locales and How to: Build a localized app for Office. For information about localizing apps for SharePoint, see Designing an app for Office for specific locales and How to: Localize apps for SharePoint.

    noteNote
    • If you want to block customers in certain countries or regions from acquiring your app, you will be given the opportunity to do so when you add or edit your app in the Seller Dashboard.

    • If you want to submit an app for SharePoint that uses OAuth and you want to distribute it in China, add a separate Client ID and secret for China, add a separate app package specifically for China, and block access for all countries except China. For more information about Client IDs, see Create Client IDs and Secrets in the Microsoft Seller Dashboard.

Check box

OAuth Client ID (if needed)

  • App for SharePoint

If your app is a service and requires server-to-server authorization, then you need a Client ID and client secret. You create the Client ID and secret in the Seller Dashboard.

noteNote
If you want to submit an app for SharePoint that uses OAuth and you want to distribute it in China, add a separate Client ID and secret for China, add a separate app package specifically for China, and block access for all countries except China.

For more information, see Create Client IDs and Secrets in the Microsoft Seller Dashboard.

Check box

Testing notes

  • App for Office

  • App for SharePoint

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 Office Store listing. If you provide complete Testing Notes, they can assist with the validation of your app.

Check box

Cryptography and encryption information

  • App for Office

  • App for SharePoint

You will need to specify if your app calls, supports, contains, or uses cryptography or encryption. For more information about encryption, see EAR Controls For Items That Use Encryption.

Check box

App description

  • All

Your app description includes a Short Description and a Long Description that will appear in the marketplace listing for your app. The Short Description can be up to 100 characters, and the Long Description can be up to 4000 characters.

TipTip
  • Customers want to know how your apps will help them or their business. Make sure you correct any editorial issues, such as misspellings or grammatical errors. For more information, see the Understand the app approval process section in this topic.

  • To add a bulleted list, surround each list item with [#LI] and [/#LI], or you can use hyphens (“-”) as bullets in bulleted lists.

    noteNote
    At this time, you can use only one bulleted list in your description.

  • If you want to offer your apps for Office or SharePoint in multiple languages, and you want a tailored experience for customers in regional stores, you can add languages so that your app appears in those stores with localized metadata. You must write a Short Description and a Long Description in each language that you add.

Check box

Offering features

  • Azure Catalog App

Describe features and benefits for your app. Customers will see this on the features tab of your app details page.

Check box

Screenshots

  • All

You must provide at least one screenshot of your app. You can provide up to five screenshots for customers who want to learn more about your app. Customers will see these screenshots in the marketplace listing for your app, so do not include any private or personal information that you do not want customers to see.

TipTip
  • App for Office or SharePoint: Your screenshots must be in one of the following file formats: .png, .jpg, .jpeg, or .gif. They must be 512 x 384 pixels, and no greater than 300 KB.

  • Azure Catalog App: Your screenshots must be a minimum of 720 x 540 pixels and a maximum of 1440 x 1080 pixels.

  • We recommend that you scan your screenshots with a current version of virus detection software, and upload them to the Seller Dashboard only if they pass the virus scan. If you need virus detection software, see the Microsoft Safety & Security Center.

  • If you are adding apps for Office or SharePoint, and you add multiple languages to your app submission, you can add language-specific screenshots for your app. You must provide at least one screenshot of your app for each language that you add. Screenshots that match each language provide the best customer experience.

Check box

Learn more URL

  • Azure Catalog App

Provide a URL where your customers can learn more about your app.

Check box

Support document link

  • All

Provide a link to your support documentation. Include http:// or https:// in your URL. This could include a getting started guide, a FAQ, sample data, or other support resources. It should also include contact details so that the customer can contact you or a support person about your app.

Check box

Privacy document link

  • App for Office

  • App for SharePoint

Provide a link to a privacy policy. Include http:// or https:// in your URL.

noteNote
  • If your app enables access to and use of Internet-based or mobile services, or collects and/or transmits user information to you or a third party, you must provide a link to a privacy statement that contains privacy details that will be published with your app.

  • The Seller Dashboard now requires a link to your privacy document. If you submitted your app before a link to your privacy document was required in the Seller Dashboard, the link to privacy information on your app’s listing page will call out that a privacy statement was not provided. To add the link to an approved app, you can Edit your app, add the link, and submit the app for approval again.

Check box

Video link (optional)

  • App for Office

  • App for SharePoint

If you have a video that demonstrates your app, you can provide a link to it that will be included in your app listing.

Check box

Customized end user license agreement (optional)

  • App for Office

  • App for SharePoint

If you have a customized license agreement, you can upload it to the Seller Dashboard. If not, the Office Store will provide a standard license agreement for your app. For details, see Office Store Standard Application License Terms.

For more information about licensing, see Licensing apps for Office and SharePoint, Creating and verifying licensing in a paid app for Office, and Licensing your apps for SharePoint.

Check box

Pricing information

  • App for Office

  • App for SharePoint

You can list your app for free, for one-time purchase, or as a monthly, auto-renewing subscription. You can add this information at any time, so if you decide to list your app for purchase at a later date, you can add pricing information at that time.

noteNote
  • If you list your app for one-time purchase or as a subscription, you must provide payout and tax information. For more information, see Add payout and tax information and submit it for validation.

  • The app price is set at the app level. If you add multiple languages to your app submission, you set only one price. You don’t set a price for each language. The price customers will see is in the currency associated with the Office Store in which your app is sold.

  • You can’t change the pricing on an app from subscription to one-time purchase, or from one-time purchase to subscription, once you have submitted your app. This includes any apps you submitted before the subscription pricing option was available.

  • Currently, mail apps and Azure Catalog Apps can only be listed as free.

For more information, see Decide on a pricing model for your app for Office or SharePoint.

Check box

Trial information

  • App for Office

  • App for SharePoint

For one-time purchase or subscription apps, you can choose if you want to offer your app as a trial, and if so, the duration of that trial and the number of users.

Check box

Payout and tax information

  • App for Office

  • App for SharePoint

If you want to list your app for purchase, either for one-time purchase or as a subscription, you must also provide payout and tax information. This information must be validated before you can submit an app for purchase. For more information, see the Add payout and tax information and submit it for validation section in Create Your Account and Add Payout Information in the Microsoft Seller Dashboard.

Check box

App appropriately localized

  • App for Office

  • App for SharePoint

If your app supports multiple languages, make sure that your app has been appropriately localized, in order to pass validation. If your app supports multiple languages and has not been appropriately localized, it will not pass validation and won’t be approved.

For information about localizing apps for Office, see Designing an app for Office for specific locales and How to: Build a localized app for Office. For information about localizing apps for SharePoint, see Designing an app for Office for specific locales and How to: Localize apps for SharePoint.

Check box

Add and submit apps in the Seller Dashboard

Add an app and save it as a draft

You can add and save apps as drafts in your Seller Dashboard account. This is available even if your account is pending approval or if you want to begin the process of adding an app but don’t want to submit it for approval yet.

noteNote

To add an app to the Seller Dashboard, follow these steps:

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

  2. On the APPS tab, under manage, click add a new app.

  3. In the NEW APP wizard, on the listing type page, click the app type that matches your app.

  4. If this is the first time you are creating an app for the marketplace that lists your selected app type, an agreement will appear. Under marketplace terms and conditions, read the agreement. If you agree, click the check box, and then click NEXT.

    noteNote
    • If you agree, you will only see the agreement for this marketplace once, unless an updated version of the agreement becomes available. If you add another app for this same marketplace, then this same agreement applies. If you add an app for a different marketplace, you will see a different marketplace agreement.

    • After you add your app, if you want to see a list of accepted agreements, click the ACCOUNT tab. On the manage tab, under terms and conditions, there is a list of agreements that you have accepted. To see the details of an agreement, click the name of the agreement.

  5. On the overview page, do the following:

    1. Under general info, provide the information, which may include App Title, Version, and Release Date, depending upon your app type.

      ImportantImportant
      The number you provide for the Version in the Seller Dashboard must exactly match the version number in the app package you submit.

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

    3. Under logo, click the App Logo tile, and upload your logo.

      noteNote
      For apps for Office and 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.

    4. Under app package do the following:

      noteNote
      You may or may not see app package, depending upon your app type.

      1. Click the app package tile, and then upload your app binary or manifest.

        noteNote
        If you want to submit an app for SharePoint that uses OAuth and you want to distribute it in China, add a separate app package specifically for China.

      2. If the app type you chose supports OAuth Client IDs, you will see the My app is a service and requires server to server authorization option. If your app will use OAuth, click the check box and select the OAuth Client ID that your app will use.

        noteNote
        If you want to submit an app for SharePoint that uses OAuth and you want to distribute it in China, add a separate Client ID and secret for China. Under OAuth Client ID, click the drop-down arrow. Under Client IDs for Apps in China, select a Client ID. If you don’t see this option, you need to add a Client ID for China only.

        For more information, see Create Client IDs and Secrets in the Microsoft Seller Dashboard.

      3. Under Testing Notes, provide instructions and links to resources that will help validation testers validate your app. 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 Office Store listing. If you provide complete Testing Notes, they can assist with the approval of your app.

      4. If your app calls, supports, contains, or uses cryptography or encryption, click the check box, verify the information, and then click Yes or No.

      5. If you are adding an app for Office or SharePoint, under support documents, provide a Support Document Link and a Privacy Document Link for your app. Include http:// or https:// in your URLs. You can also provide a Video Link, and a customized End User License Agreement. If you don’t have a customized license agreement, the Office Store will provide a license agreement for your app.

  6. Click NEXT.

  7. On the details page, do the following:

    1. If you are adding an app for Office or SharePoint, under language, click CHOOSE A LANGUAGE.

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

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

    3. Under description, if you are adding an app for Office or SharePoint, provide your App Name, Short Description, and Long Description in the language you chose in the previous step. For example, if you chose English in the previous step, type your App Name, Short Description, and Long Description in English.

    4. If you are adding an Azure Catalog App, provide the Short Description, Long Description, and Offering Features for your app.

    5. Under screenshots, click the Primary tile to upload at least one screenshot of your app. You can upload up to five screenshots of your app.

      ImportantImportant
      • Customers will see your screenshots in the marketplace listing for your app, so do not include any private or personal information that you do not want customers to see.

      • If you are adding an app for Office or SharePoint, you can add language-specific screenshots to match each language. Screenshots that match each language provide the best customer experience.

    6. If you are adding an Azure Catalog App, under learn more, provide a link to your information. Under support documents, provide a link to your support documentation for your app. Include http:// or https:// in your URL.

  8. If you are adding an Azure Catalog App, click the SAVE AS DRAFT button.

    If you have added all the languages for your app for Office or SharePoint, and you want to proceed, skip to the next step in this procedure. If you want to add another language, click the ADD A LANGUAGE button.

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

    1. After you click the ADD A LANGUAGE button, click the language for your app details, and then click CONFIRM.

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

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

    3. Under screenshots, click the Primary tile to upload at least one screenshot of your app. You can upload up to five screenshots of your app.

      ImportantImportant
      • Customers will see your screenshots in the marketplace listing for your app, so do not include any private or personal information that you do not want customers to see.

      • If you add additional languages to your app, you can add language-specific screenshots for your app. Screenshots that match each language provide the best customer experience.

    4. If you want to add another language for your app for Office or SharePoint, click the ADD A LANGUAGE button, and repeat the previous three steps.

  9. To proceed or to block customers in certain countries or regions from purchasing or accessing your app for Office or SharePoint, click NEXT.

  10. On the block access page, do the following:

    1. If you don’t want to block customers in certain countries or regions from accessing your app, click NEXT to add pricing information.

    2. If you want to block access, under blocking, click the Block customers in certain countries or regions from accessing this app check box, and then click the SELECT COUNTRIES OR REGIONS button.

      noteNote
      If you want to submit an app for SharePoint that uses OAuth and you want to distribute it in China, block access for all countries except China. You also need to add a separate Client ID and secret for China, and add a separate app package specifically for China. For more information about Client IDs, see Create Client IDs and Secrets in the Microsoft Seller Dashboard.

    3. In the Select which countries or regions you would like to block dialog box, select the countries or regions in which you want to block customers from purchasing or accessing your app.

      noteNote
      If you select all countries and regions from the list, then your app will not be visible in any Office Store. Clear at least one check box to publish your app in an Office Store.

    4. When you have finished selecting countries or regions you want to block, click the BLOCK COUNTRIES OR REGIONS button.

  11. To add pricing information for your app for Office or SharePoint, click NEXT.

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

    • If you want to list your app for one-time purchase or subscription, you must also provide payout and tax information. For more information, see Add payout and tax information and submit it for validation.

    • You can also add pricing information later. Click the SAVE AS DRAFT button and come back later to finish adding your pricing information.

  12. On the pricing page, do the following:

    1. If your app is free, click This app is free.

    2. If your app is for one-time purchase, click This app is for one-time purchase, and then select the Price Per User.

    3. If you want to offer your app as a monthly, auto-renewing subscription, click This app will be sold as a subscription, and then select the Price Per User.

    4. If you want to place a limit on the maximum a buyer pays for either a one-time purchase or a subscription, choose a Price Threshold. If you choose No threshold, then the buyer pays the Price Per User for each user.

      noteNote
      • The Price Per User multiplied by the Price Threshold equals the maximum a buyer will pay for unlimited users.

        • For example, if the Price Per User equals $1.99 USD, with a Price Threshold equal to 10 users, then the maximum price for unlimited users equals $19.90. The buyer pays $1.99 for each user up to 10 users, with no additional charge for 11 or more users.

      • The app price is set at the app level. If you add multiple languages to your app submission, you set only one price, rather than setting a price for each language. The price customers will see is in the currency associated with the Office Store in which your app is sold.

      • You can’t change the pricing on an app from subscription to one-time purchase, or from one-time purchase to subscription, once you have submitted your app. This includes any apps you submitted before the subscription pricing option was available.

      For more information, see Decide on a pricing model for your app for Office or SharePoint.

    5. If you offer a trial of your one-time purchase or subscription app, under trial support, click the My app supports a trial check box, and then select the duration and number of users for your trial.

  13. Click the SAVE AS DRAFT button.

Submit an app for approval

After your account in the Seller Dashboard is approved, you can submit apps for approval. If you want to submit an app for purchase, your payout and tax information must also be validated before you can submit an app for approval. See Add payout and tax information and submit it for validation if you have not yet added this information in the Seller Dashboard. Your approved apps will be listed in product-specific marketplaces.

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 preceding section to add an app. In the final step of that procedure, click the SUBMIT FOR APPROVAL button instead of the SAVE AS DRAFT button.

  • 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, click the APPS tab. Under manage, click the app you want to edit and submit. On the app summary page, click EDIT DRAFT and make your changes. Click the SUBMIT DRAFT FOR APPROVAL button.

  • If you want to submit an app that you saved to the Seller Dashboard as a draft without making changes, click the APPS tab. Under manage, click the app you want to submit. On the app summary page, click the SUBMIT DRAFT FOR APPROVAL button.

    noteNote
    After you have submitted an app for approval, no changes can be made to your app during the approval process. When the validation process is complete, you will receive an email message, alerting you if your app was approved or if your app needs changes to be approved. You can then edit your app, if necessary. For more information, see the Edit your app section in the Update, Unpublish, and Track Your Apps with Metrics in the Microsoft Seller Dashboard topic.

Understand the app approval process

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 cannot 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 any 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. This associated material must use correct spelling, capitalization, punctuation, and grammar.

  • If you are submitting apps for Office or SharePoint, and your app supports multiple languages, you must add localized metadata for each language. Apps with web services and functionality that support these additional languages provide the best customer experience. You must also provide app descriptions in the languages your app is localized to.

noteNote
For more information about requirements for Office Store apps, including apps for Office and SharePoint, see Validation policies for the apps submitted to the Office Store.

Check your app approval status

You will receive an email message when the validation process is complete, alerting you if your app was approved or if your app needs changes to be approved. 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 the status is pending approval, you can’t edit your app.

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

      noteNote
      Once your app is approved in the Seller Dashboard, there may be a delay before it is published in a marketplace. After approval, apps for Office and SharePoint typically appear in the Office Store within 24 hours. If you have 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.

See Also

Show:
© 2014 Microsoft