Export (0) Print
Expand All

Checklist for submitting an app to the Microsoft Seller Dashboard

apps for Office and SharePoint

Learn about prerequisites and other information you need to have ready before you can add/submit apps to the Seller Dashboard for approval and inclusion in the Office Store.

Last modified: August 25, 2014

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

Review validation policies, regional information, distributing apps for China, and supported languages

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

  • Validation policies: Review the current Validation policies for the apps submitted to the Office Store (version 1.5) and Validation checklist for apps for Office and SharePoint to avoid common mistakes and verify that you’re fully compliant with the current validation policies requirements. This will help verify that your app will pass validation when it is submitted to the Office Store for approval.

  • Regional information: Check the Regional Information for the Microsoft Seller Dashboard to verify that you reside in a country or region that the Seller Dashboard supports.

  • Distributing apps for China: 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).

  • Languages: To offer your app in languages beyond the primary language, you will need localized metadata for each additional language. The best customer experience is with apps that have web services and functionality that support these additional languages. You will also need to create app descriptions in the languages your app is localized to. The Seller Dashboard currently accepts English, French, German, Japanese, and Spanish.

     

    Note Note

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

    To distribute your app in additional languages, you can edit the app details in the Seller Dashboard. After you add other languages, you will need to submit it for approval again.

    In the case of previously approved apps, if you updated your manifest, you will need to ensure that you update the app version in the manifest and in the submission form. The current app version will remain in the Office Store until your new app is approved, unless you unpublish the current app. For more information, see How to: Update, unpublish, and track your app metrics.

    Note Note

    To block customers in a certain country/region from acquiring or using your app, you can do so when you add or edit your app in the Seller Dashboard.

Prepare your app information

Before you add apps in the Seller Dashboard, prepare the information in the following checklist. For additional tips and examples , see Quick steps to drive more downloads.

Table 1. Checklist for submitting apps

What you need

Notes

Ready

App type

Your choices are app for Office, app for Outlook, and app for SharePoint.

Seller Dashboard checklist checkbox

App title

Your App Title appears in the listing on the Office Store. A shorter title displays well on webpages, so use an app title is no more than 15 characters. The title can be up to 50 characters.

Tip Tip

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.

Seller Dashboard checklist checkbox

App name

To offer your apps in multiple languages, you can provide an App Name in each language. The Seller Dashboard currently accepts English, French, German, Japanese, and Spanish.

Tip Tip

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

Seller Dashboard checklist checkbox

Version

The version number you provide for the Version must exactly match the version number in the app manifest file of the app you submit. For more information, see Validation policies for the apps submitted to the Office Store (version 1.5).

Seller Dashboard checklist checkbox

Release date

This is the date your app is released and listed in the store. The release date does not determine the date on which your app is made available on the Office Store.

Seller Dashboard checklist checkbox

Category

Choose at least one category to use as a filter in the Office Store to help customers find your app. You can choose up to three categories.

Seller Dashboard checklist checkbox

App logo

A picture you want customers to associate with your app that will appear in the store listing for your app.

Note Note
  • Your logo 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.

  • 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, visit the Microsoft Safety & Security Center.

  • Only one logo is associated with your app. If your logo requires localization, submit your localized apps as separate submissions in order to use a different app logo for each language.

Seller Dashboard checklist checkbox

App package

Your app binary file or manifest file that you upload to the Seller Dashboard.

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

  • 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, visit the Microsoft Safety & Security Center.

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

For more information about maintaining consistency between this app logo image and the one you include in the app package, see Create a consistent visual identity for your app in How to: Create an effective Office Store listing for your app for Office or SharePoint.

Seller Dashboard checklist checkbox

OAuth Client ID (if required)

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

Note Note

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

For more information, see How to: Create or update client IDs and secrets in the Microsoft Seller Dashboard.

Seller Dashboard checklist checkbox

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 in the validation and approval of your app.

Seller Dashboard checklist checkbox

Cryptography and encryption information

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.

Seller Dashboard checklist checkbox

App description

This includes a Short Description and a Long Description that will appear in the store listing for your app. The short description can be up to 100 characters, and the long description can be up to 4,000 characters.

If you want a tailored experience for users in a regional store, you can add other languages so that your app appears in other language stores with localized metadata. If you add a language, you must write a Short Description and a Long Description in that language. The Seller Dashboard accepts English, French, German, Japanese, and Spanish.

Tip Tip
  • Customers want to know how your apps will help them or their business, so be sure to provide specific information about what your app can do for them. For more information, see the Understand the app approval process section in How to: Submit apps for SharePoint to the Microsoft Seller Dashboard.

  • Verify that you correct any issues, such as misspellings or grammatical errors.

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

    Note Note

    If you use more than one bulleted list, the content after the first list will not appear in the description on the listing page for your app.

Seller Dashboard checklist checkbox

Screen shots

Provide at least one screen shot of your app. You can provide up to five screen shots for customers who want to learn more about your app. Customers will be able to see these images in the store listing for your app, so do not include any private or personal information that you don't want customers to see.

If you add other languages to your app submission, you can add language-specific screen shots for your app. Screen shots that match each language provide the best customer experience.

  • Your screen shots must be in one of the following file formats: .png, .jpg, .jpeg, or .gif.

  • They must be 512 x 384 pixels, and can be no greater than 300 KB.

  • Screen shots must be unmanipulated images of your app running in a licensed copy of Office.

  • Scan your images 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, visit the Microsoft Safety & Security Center.

Seller Dashboard checklist checkbox

Support document link

Provide a link to your support documentation, including http:// or https:// in your URL. The support link should include contact details so that users can contact you or a support person about your app.

In addition, make sure that you include the SupportUrl element in your manifest file. You may need to add this element to the manifest file, because it is not included there by default.

This entry should be of the form

<SupportUrl DefaultValue="http://www. yoursupportURL.com/" />

Also see SupportUrl element (OfficeApp complexType) (app manifest schema v1.1).

Seller Dashboard checklist checkbox

Privacy policy notification link (optional)

Provide a link to a privacy policy.

Note Note

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 the listing page of your app will call out that a privacy statement was not provided: Privacy Statement.

To add the link to a privacy policy to an approved app, you can edit your app, add the link, and submit the app for approval again. For more information about how to edit your app, see How to: Update, unpublish, and track your app metrics.

Seller Dashboard checklist checkbox

Video link (optional)

If you have a video that demonstrates your app, you can provide a link to it. This video will appear in the listing page for the app.

Seller Dashboard checklist checkbox

Customized end-user license agreement (optional)

If you have a customized license agreement, you can upload it. If you do not, the store will provide a license agreement for your app. For more information, see Office Store Standard Application License Terms.

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

Seller Dashboard checklist checkbox

Pricing information

App price is set at the app level. You don’t set a price for each language. You set a price tier. The price shown to customers is in the currency associated with the store the app is being sold in.

You can list your app for free, for a one-time purchase, or as a perpetual monthly subscription. For paid or subscriptions apps, you can also choose if you want to offer your app as a trial, and if so, the duration of that trial.

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

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

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

These setting do not apply to apps for Office.

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.

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.

Note Note

Currently, mail apps can only be listed as free.

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.

Seller Dashboard checklist checkbox

Trial information

If your app supports a trial, you will need to specify the duration of the trial, and the number of users.

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

Seller Dashboard checklist checkbox

Payout and tax information

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 Create Your Account and Add Payout Information in the Microsoft Seller Dashboard.

Seller Dashboard checklist checkbox

App appropriately localized

If your app supports multiple languages, verify that that your app has been appropriately localized, or it will not pass validation and won’t be approved.

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

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

Seller Dashboard checklist checkbox

Localized Office Store fronts

The Office Store is now available in five languages (English, French, German, Japanese, and Spanish) in 23 corresponding markets, as listed in Table 2. In each of these markets, the Office Store displays app metadata in either English or the corresponding language. When you submit an app for Office, you can provide metadata (descriptions, screen shots, title) in the languages that you would like your app to be listed in, and explicitly specify these languages as submission languages in the Seller Dashboard. Verify that the primary submission language is in the app manifest. If English is the only submission language, by default, your app will be listed in the Office Store fronts in all 23 markets with English metadata. If any of the four non-English languages (French, German, Japanese, and Spanish) is a submission language, your app will be listed in the Office Store fronts in the corresponding markets, with metadata in that non-English language. If English and any of the four non-English languages are submission languages, the app will be listed in all the 23 markets with English metadata, except for those markets for which the corresponding non-English language has been submitted, where the metadata will be in the corresponding non-English language.

In the Seller Dashboard, you can explicitly block markets in which to distribute your app. The five languages are a subset of the languages and locales that you can localize an app in and specify in the manifest. If you localized your app in some other supported languages, specify English in the manifest and as a submission language in the Seller Dashboard to get the app listed in the Office Store fronts in all the 23 markets.

Users can verify whether a market-specific Office Store front is available for a market by selecting that market in the upper-right of the store page, as shown in Figure 1. From there, users either are directed to the market-specific store front, or if that store front is not available, see a message that suggests that they go the Office Store in the United States.

Figure 1. Verify or choose a different market in the Office Store

Choose a different market for the Office Store.

Table 2 lists the submission languages that the Office Store is available in, and the locales and markets that correspond to each of these languages. Language identifiers and OptionState Id values in Office 2013 lists all the languages and locales for which you can localize an app. For more information about localizing an app, see Designing an app for Office for specific locales and How to: Build a localized app for Office. For more information about submitting an app and specifying submission languages in the Seller Dashboard, see How to: Submit apps for SharePoint to the Microsoft Seller Dashboard.

Table 2. List of distribution languages and corresponding markets for the Office Store

Submission language

Locale (language tag)

Market (country or region)

English

en-us

United States

English

en-au

Australia

English

en-ca

Canada - English

English

en-gb

United Kingdom

English

en-in

India

English

en-ie

Ireland

English

en-nz

New Zealand

English

en-sg

Singapore

English

en-za

South Africa

English

en-001

International English

French

fr-fr

France

French

fr-be

Belgium

French

fr-ca

Canada - French

French

fr-ch

Switzerland

French

fr-001

International French

German

de-de

Germany

German

de-at

Austria

German

de-ch

Switzerland

Japanese

ja-jp

Japan

Spanish

es-es

Spain

Spanish

es-mx

Mexico

Spanish

es-hn

Latam

Spanish

es-ar

Argentina

You can use the Microsoft Seller Dashboard to submit apps for Office and SharePoint to the Office Store. For more information about how to submit your apps for approval and inclusion in the Office Store, see How to: Submit apps for Office to the Microsoft Seller Dashboard and How to: Submit apps for SharePoint to the Microsoft Seller Dashboard.

Show:
© 2014 Microsoft