---
id: video/9i6hVsw9x_U
type: video
title: AppSource App Previews
summary: "Installing preview versions of AppSource apps in Business Central: how publishers set a preview key in Partner Center and share an install URL, and how administrators install, update and monitor previews. Covers sandbox-only installation, the highest-version rule, breaking changes between previews, and telemetry."
tier: official
language: en
tags:
  - appsource
  - preview versions
  - app installation
  - marketplace
  - sandbox environments
  - partner center
  - preview key
  - telemetry
system: integration
review:
  state: reviewed
  by: opus
  at: "2026-10-07T23:12:18.794Z"
  flags: []
generated:
  at: "2026-10-07T23:12:18.829Z"
  pipeline: 0.2.0
  prompts:
    extract-video: 1
    summarize-video: 2
  input_hash: 36d3c1ccb081854934985a4afc0a943c5ddefff24e1fcf061612eafbe6b5b562
evidence:
  - kind: video
    url: https://www.youtube.com/watch?v=9i6hVsw9x_U&t=3s
    title: AppSource App Previews
    date: "2024-02-02T12:05:58.000Z"
    commit: null
    t: 3
    quote: We will explore today the capabilities of installing preview versions of AppSource apps in Business Central and see how you can leverage this to
  - kind: video
    url: https://www.youtube.com/watch?v=9i6hVsw9x_U&t=90s
    title: AppSource App Previews
    date: "2024-02-02T12:05:58.000Z"
    commit: null
    t: 90
    quote: We are currently only supporting to install preview versions which are the highest version of your extension
  - kind: video
    url: https://www.youtube.com/watch?v=9i6hVsw9x_U&t=101s
    title: AppSource App Previews
    date: "2024-02-02T12:05:58.000Z"
    commit: null
    t: 101
    quote: If you have public version that is higher, even if you're giving a link with a preview key to your customers, this public version
  - kind: video
    url: https://www.youtube.com/watch?v=9i6hVsw9x_U&t=135s
    title: AppSource App Previews
    date: "2024-02-02T12:05:58.000Z"
    commit: null
    t: 135
    quote: You will be allowed to perform breaking changes between preview versions of your extensions
  - kind: video
    url: https://www.youtube.com/watch?v=9i6hVsw9x_U&t=152s
    title: AppSource App Previews
    date: "2024-02-02T12:05:58.000Z"
    commit: null
    t: 152
    quote: when you're submitting a preview version of your app, you should include all the required dependencies as needed.
  - kind: video
    url: https://www.youtube.com/watch?v=9i6hVsw9x_U&t=169s
    title: AppSource App Previews
    date: "2024-02-02T12:05:58.000Z"
    commit: null
    t: 169
    quote: previews can only be installed on sandbox environments. You cannot install them on production environments
  - kind: video
    url: https://www.youtube.com/watch?v=9i6hVsw9x_U&t=200s
    title: AppSource App Previews
    date: "2024-02-02T12:05:58.000Z"
    commit: null
    t: 200
    quote: Installed preview versions are automatically updated to higher public version with app update guidance setting
links:
  learn: []
  objects: []
  features: []
  topics: []
  localizations: []
  videos: []
  posts: []
  guidelines: []
video_id: 9i6hVsw9x_U
channel: yt-microsoft
source_name: Microsoft Dynamics 365 Business Central (YouTube)
url: https://www.youtube.com/watch?v=9i6hVsw9x_U
published_at: "2024-02-02T12:05:58.000Z"
duration_s: 252
captions: full
audience:
  - partner
  - developer
  - administrator
chapters:
  - t: 0
    title: Introduction to AppSource Preview Versions
  - t: 19
    title: Overview for Publishers and Administrators
  - t: 34
    title: Setting Up Preview Keys and Installation URL
  - t: 72
    title: AppSource Publishers - Preview Version Behavior
  - t: 112
    title: Publishing Options and Breaking Changes Policy
  - t: 169
    title: Administrator Capabilities and Environment Restrictions
  - t: 210
    title: Telemetry and Closing Remarks
features:
  - name: Preview Key for AppSource Apps
    status: unclear
    t: 34
    verified: false
    status_source: video
  - name: Preview Version Installation URL
    status: unclear
    t: 48
    verified: false
    status_source: video
  - name: Automatic Preview Key Generation
    status: unclear
    t: 112
    verified: false
    status_source: video
  - name: Simultaneous Preview Versions
    status: unclear
    t: 122
    verified: false
    status_source: video
  - name: Breaking Changes in Preview Versions
    status: unclear
    t: 135
    verified: false
    status_source: video
  - name: Sandbox-Only Preview Installation
    status: unclear
    t: 169
    verified: false
    status_source: video
  - name: Preview to Public Version Updates
    status: unclear
    t: 185
    verified: false
    status_source: video
  - name: Automatic Public Version Promotion
    status: unclear
    t: 200
    verified: false
    status_source: video
  - name: Preview Version Telemetry Logging
    status: unclear
    t: 210
    verified: false
    status_source: video
objects_mentioned: []
quotes:
  - t: 3
    text: We will explore today the capabilities of installing preview versions of AppSource apps in Business Central and see how you can leverage this to
    check: exact
  - t: 90
    text: We are currently only supporting to install preview versions which are the highest version of your extension
    check: exact
  - t: 101
    text: If you have public version that is higher, even if you're giving a link with a preview key to your customers, this public version
    check: exact
  - t: 135
    text: You will be allowed to perform breaking changes between preview versions of your extensions
    check: exact
  - t: 152
    text: when you're submitting a preview version of your app, you should include all the required dependencies as needed.
    check: exact
  - t: 169
    text: previews can only be installed on sandbox environments. You cannot install them on production environments
    check: exact
  - t: 200
    text: Installed preview versions are automatically updated to higher public version with app update guidance setting
    check: exact
---

# AppSource App Previews

> Installing preview versions of AppSource apps in Business Central: how publishers set a preview key in Partner Center and share an install URL, and how administrators install, update and monitor previews. Covers sandbox-only installation, the highest-version rule, breaking changes between previews, and telemetry.

[Watch on YouTube](https://www.youtube.com/watch?v=9i6hVsw9x_U) · Microsoft Dynamics 365 Business Central (YouTube) · 2024-02-02 · 4:12 · tier official · reviewed (checked by Opus)

## Overview

The video explains how AppSource publishers can make preview versions of their extensions available to selected customers before public release. Publishers specify a preview (hide) key in Partner Center, or get one generated automatically if they do not set one during submission. They then build an installation URL that contains the tenant ID, app ID and preview key.

It also covers the administrator side. Previews can only be installed on sandbox environments and can be updated to higher previews or to public versions. Operations on extensions are logged to telemetry, including whether an installed app is a preview or public version.

## Key points

- Publishers set a preview (hide) key in Partner Center; if none is given at marketplace submission, one is generated automatically and the publisher is opted in.
- The install URL contains the tenant ID, app ID and preview key, and customers use it to install a preview.
- Only a preview that is the highest version of the extension can be installed. If a public version is higher, the public version is installed even when the link has a preview key.
- Previews install only on sandbox environments, not production. Sandboxes with preview versions cannot be copied or restored to production.
- Publishers can run simultaneous previews for different offers with different preview keys, even when the offers contain the same apps.
- Breaking changes are allowed between preview versions, but must not be introduced to the latest public version.
- A preview submission must include all required dependencies, otherwise the Partner Center submission might fail.

## Chapters

- [0:00](https://www.youtube.com/watch?v=9i6hVsw9x_U&t=0s) Introduction to AppSource Preview Versions
- [0:19](https://www.youtube.com/watch?v=9i6hVsw9x_U&t=19s) Overview for Publishers and Administrators
- [0:34](https://www.youtube.com/watch?v=9i6hVsw9x_U&t=34s) Setting Up Preview Keys and Installation URL
- [1:12](https://www.youtube.com/watch?v=9i6hVsw9x_U&t=72s) AppSource Publishers - Preview Version Behavior
- [1:52](https://www.youtube.com/watch?v=9i6hVsw9x_U&t=112s) Publishing Options and Breaking Changes Policy
- [2:49](https://www.youtube.com/watch?v=9i6hVsw9x_U&t=169s) Administrator Capabilities and Environment Restrictions
- [3:30](https://www.youtube.com/watch?v=9i6hVsw9x_U&t=210s) Telemetry and Closing Remarks

## Features

| Feature | Status | At |
|---|---|---|
| Preview Key for AppSource Apps | status not stated, demoed | [0:34](https://www.youtube.com/watch?v=9i6hVsw9x_U&t=34s) |
| Preview Version Installation URL | status not stated, demoed | [0:48](https://www.youtube.com/watch?v=9i6hVsw9x_U&t=48s) |
| Automatic Preview Key Generation | status not stated | [1:52](https://www.youtube.com/watch?v=9i6hVsw9x_U&t=112s) |
| Simultaneous Preview Versions | status not stated | [2:02](https://www.youtube.com/watch?v=9i6hVsw9x_U&t=122s) |
| Breaking Changes in Preview Versions | status not stated | [2:15](https://www.youtube.com/watch?v=9i6hVsw9x_U&t=135s) |
| Sandbox-Only Preview Installation | status not stated | [2:49](https://www.youtube.com/watch?v=9i6hVsw9x_U&t=169s) |
| Preview to Public Version Updates | status not stated | [3:05](https://www.youtube.com/watch?v=9i6hVsw9x_U&t=185s) |
| Automatic Public Version Promotion | status not stated | [3:20](https://www.youtube.com/watch?v=9i6hVsw9x_U&t=200s) |
| Preview Version Telemetry Logging | status not stated | [3:30](https://www.youtube.com/watch?v=9i6hVsw9x_U&t=210s) |

## Quotes

- [0:03](https://www.youtube.com/watch?v=9i6hVsw9x_U&t=3s) "We will explore today the capabilities of installing preview versions of AppSource apps in Business Central and see how you can leverage this to"
- [1:30](https://www.youtube.com/watch?v=9i6hVsw9x_U&t=90s) "We are currently only supporting to install preview versions which are the highest version of your extension"
- [1:41](https://www.youtube.com/watch?v=9i6hVsw9x_U&t=101s) "If you have public version that is higher, even if you're giving a link with a preview key to your customers, this public version"
- [2:15](https://www.youtube.com/watch?v=9i6hVsw9x_U&t=135s) "You will be allowed to perform breaking changes between preview versions of your extensions"
- [2:32](https://www.youtube.com/watch?v=9i6hVsw9x_U&t=152s) "when you're submitting a preview version of your app, you should include all the required dependencies as needed."
- [2:49](https://www.youtube.com/watch?v=9i6hVsw9x_U&t=169s) "previews can only be installed on sandbox environments. You cannot install them on production environments"
- [3:20](https://www.youtube.com/watch?v=9i6hVsw9x_U&t=200s) "Installed preview versions are automatically updated to higher public version with app update guidance setting"