Promote your AppSource solution

After you submit your solution and it's approved for addition to AppSource, you might want to brand it as an AppSource solution on your webpage. You can use the AppSource badges to promote your solution and drive traffic from your site to AppSource. To do so:

  1. Download the AppSource Badge zip file.

  2. Select the badge size that best suits your needs.

    Badge size How it looks
    Small Screenshot of the small-sized AppSource badge
    Medium Screenshot of the medium-sized AppSource badge
    Large Screenshot of the large-sized AppSource badge
  3. Add the badge to your app or add-in webpage, directly following the link. This makes it clear to your users that they can download your app or add-in from AppSource.

You can also add your Office 365 web app using Azure AD to the Office 365 app launcher. For information, see Add custom tiles to the app launcher.

Guidelines for using the AppSource badge

The following guidelines apply to using the AppSource badge on your webpage:

  • Make the AppSource badge visually distinct. Do not overlap it with or incorporate it within any other icon or brand image on your page.
  • Do not modify the badge.
  • Do not make the badge the primary element on your webpage.
  • Do not use the badge on any pages that violate laws or regulations or that contain otherwise objectionable content. This includes pages that contain or display adult content, promote gambling, promote violence, or contain hate speech.
  • Make sure that when users choose the badge, the link opens your page in AppSource, and that your app or add-in is available in AppSource.

If you need a localized version of the badge, contact us.

Track your campaign performance and customize your add-in for targeted audiences


Campaign tracking is enabled for all Office 365 listings on AppSource. Currently, activation data is only provided for Word, Excel, and PowerPoint add-ins currently.

When you link from your promotional campaigns to your free Word, Excel, or PowerPoint add-in page in AppSource, include the following query parameters at the end of the URL:

  • mktcmpid - Your marketing campaign ID, which can include up to 16 characters (any letter, number, _, and -). For example, blogpost_12. This value will be used to provide a breakdown in the Acquisitions report.
  • src - This is an optional parameter that declares the source of the user traffic.

The following example shows a URL that includes the two query parameters:

Adding these parameters to your campaign URL enables us to provide more information about your campaign's user funnel. The Acquisitions report in the Partner Dashboard will provide you a breakdown of your AppSource campaign results.

The mktcmpid parameter is passed all the way to the launch document. This allows you to customize the first user experience of your free Word, Excel, or PowerPoint add-in to, for example, display a specific splash screen or welcome message to your targeted audience.

When the document loads for the targeted user, the mktcmpid parameter is available in the Settings object of the add-in as a Microsoft.Office.CampaignId, in Office clients where the Settings object is supported. Use the following code to read the Microsoft.Office.CampaignId from the Settings object.

if (Office.context.document.settings) {
    return Office.context.document.settings.get("Microsoft.Office.CampaignId");

The value that is sent to the document is the value of the mktcmpid parameter.

See also