web
You’re offline. This is a read only version of the page.
close
Skip to main content

Announcements

Introducing our New Video Series: Community Spotlight
News and Announcements icon
Community site session details

Community site session details

Session Id :
Dynamics 365 Community / Forums / Small and medium business | Business Central, N... / How the deploy Extensi...
Small and medium business | Business Central, N...
Suggested Answer

How the deploy Extension Work's in Production Using "schemaUpdateMode": "Synchronize" in Business Central

(0) ShareShare
ReportReport
Posted on by Inkey Solutions 2,122

HI All,

I have made one custom extension which include custom table and custom pages, and have deployed .app file with version 1.0.0.0 at production instance, Now I have one Question, that if I will update the same extension in future and will deploy with one extended version at production So at that time what behaviour system would consider, will my all data would be there OR would I loss my data from the system ?

Please note that I have set the SchemaUpdateMode = Synchronize".

Any suggestion would be appreciate.

Thank you in advance.

  

I have the same question (0)
  • Suggested answer
    Mohana Yadav Profile Picture
    Mohana Yadav 61,242 Super User 2026 Season 1 on at

    Your data will be there.

    Make sure that you increase app version every time before deploying like 1.0.0.1 etc.

  • Suggested answer
    YUN ZHU Profile Picture
    YUN ZHU 102,361 Super User 2026 Season 1 on at

    Hi, hope the following can give you some hints.

    How to Unpublish and Uninstall an Extension - Business Central | Microsoft Learn

    Similar to how you make an extension available to tenant users, there's also three operations that are related to the removal of an extension: uninstalling, unpublishing, and synchronizing in clean mode. Each operation provides a different level of removal:

    Task Description
    Uninstalling an extension
    • Done on the tenant level for a specific extension version.
    • Disables the extension on the tenant - making it unavailable to users in the client and removing any user interface that the extension provides.
    • Doesn't affect business data in the tenant, modify SQL, or run any user code. Data that has been collected by using the extension is preserved. As long as the extension hasn't been unpublished, it can be reinstalled and the data is still available.
    • For example, suppose you discovered an issue with the current extension. You could uninstall until a newer version is published.
    Unpublishing an extension
    • Done on the Dynamics 365 Business Central service instance level for a specific extension version.
    • Deletes the extension package from the application database that is mounted on the server instance. The extension is no longer available for installation on tenants of the server instance.
    • Like uninstalling an extension, unpublishing doesn't affect business data in the tenant, modify SQL, or run any user code.
    • An extension can't be unpublished if it's installed on a tenant of the server instance.
    • For example, you would unpublish an extension version when it's no longer in use by any tenant. It prevents tenant users from using the extension again. You'd typically run this operation after an extension has been upgraded on all tenants from one extension version (for example, 11.0.0.1) to newer version (11.0.0.2).
    Synchronizing in clean mode
    • Done on the tenant level for all versions of an extension.
    • Removes the database schema that's defined by the extension versions. This operation deletes all data in the extension. If a table or table extension was included in any version of the extension, the table or companion table will be deleted from the tenant database.
    • You can't synchronize in clean mode if any version of the extension is installed on a tenant of the server instance.
    • In production, use this mode primarily as a final cleanup step after all versions of an extension have been uninstalled and unpublished for good.
    • In development, this mode is useful to give you a "clean" environment when making database-schema related modifications.

Under review

Thank you for your reply! To ensure a great experience for everyone, your content is awaiting approval by our Community Managers. Please check back later.

Helpful resources

News and Announcements

Introducing our New Video Series: Community Spotlight

Quick Links

Season of Sharing Community Challenge Winners!

Congratulations to our community stars!

Women in Power Builds Momentum

Expanding mentorship, skilling, and AI innovation

Congratulations to the June Top 10 Community Leaders

These are the community rock stars!

Leaderboard > Small and medium business | Business Central, NAV, RMS

#1
OussamaSabbouh Profile Picture

OussamaSabbouh 647 Super User 2026 Season 1

#2
Gerardo Rentería García Profile Picture

Gerardo Rentería Ga... 447 Most Valuable Professional

#3
YUN ZHU Profile Picture

YUN ZHU 366 Super User 2026 Season 1

Last 30 days Overall leaderboard

Featured topics

Microsoft Training Manuals

Product updates

Dynamics 365 release plans