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

Community site session details

Session Id :
Small and medium business | Business Central, N...
Suggested answer

Extension Rollback.

(5) ShareShare
ReportReport
Posted on by 29
Hi team,
 
I am new in Business central.
I have question regarding extension rollback. Let's say I have an App.1.0.0.0 which have one table with 2 fields. i deployed the extension on my production environment.  And i created some records in the table.
Now, I added two more fields in the same table and upgrade my App.1.0.0.1 version. Deployed the extension successfully.
Now, i found that these fields are causing error in my production environment or i don't want these fields. So, i want to uninstall the App.1.0.0.1 and reinstall the App.1.0.0.0. but when i uninstalled App.1.0.0.1 then my records which i have created in the table after App.1.0.0.0 is also got deleted. because i check the box delete extension data while uninstalling the App.1.0.0.1 
when i uninstall the App.1.0.0.1 without checking the delete extension data. then we are getting error at the time of reinstalling the App.1.0.0.0 (error: "A newer version of the extension is already installed.").
Can you please help me.
How to rollback previous version of an app without any data loss or any other alternative.
 
Thanks!
I have the same question (0)
  • Suggested answer
    Valentin Castravet Profile Picture
    28,388 Super User 2025 Season 2 on at
    Extension Rollback.
    As mentioned, you can't roll back. You need to create a new higher version of your app or extension that reverts the changes you want to undo.
  • Suggested answer
    Khushbu Rajvi. Profile Picture
    18,998 Super User 2025 Season 2 on at
    Extension Rollback.
    To roll back, create a new version with the original code but a higher version number. This simulates a rollback while preserving data and complying with the upgrade-only model.
  • Suggested answer
    YUN ZHU Profile Picture
    90,070 Super User 2025 Season 2 on at
    Extension Rollback.
    Hi, you must add the version number to install and hope the following can give you some hints.
    Business Central 2021 wave 2 (BC19): In-depth testing for Force Sync mode in Production Environment (Renaming tables, Renaming fields, Changing field type…)
     
    Thanks.
    ZHU
  • Suggested answer
    Teddy Herryanto (That NAV Guy) Profile Picture
    14,038 Super User 2025 Season 2 on at
    Extension Rollback.
    You cannot rollback to the previous version.
     
    What you need to do is to use the code from v1.0.0.0 and increment it to v1.0.0.2.
    Publish the new version.
    If you introduce a new table or fields in v1.0.0.1, you need to upload with schema ForceSync.
    This will delete the table and fields that does not exist in the v1.0.0.2.
    Be cautious, because you cannot get back the data that you lost during ForceSync.
  • Suggested answer
    Ramesh Kumar Profile Picture
    7,503 Super User 2025 Season 2 on at
    Extension Rollback.
    For more detailed guidance, you can refer to the official Microsoft documentation on uninstalling extension and restoring environment 
     
     
    Thanks!
    Ramesh
     
    If this was helpful, please check the "Does this answer your question?" box and mark it as verified.
  • Suggested answer
    Saif Ali Sabri Profile Picture
    2,346 Super User 2025 Season 2 on at
    Extension Rollback.
    To roll back an extension in Business Central without losing data and without running into the "newer version already installed" error, follow these steps carefully:

    Goal: Downgrade an Extension (e.g., from 1.0.0.1 → 1.0.0.0) without Data Loss

    🔁 Step-by-Step Rollback Process
    1. Unpublish the New Version
    Uninstall the current version without deleting data:
    powershell
    CopyEdit
    Uninstall-NAVApp -ServerInstance <ServerInstanceName> -Name "<AppName>" -Version 1.0.0.1 -DoNotSaveData
    🔸 Do not check the “delete extension data” box or use -Force in a way that removes data.
    2. Unpublish the New Version
    Now unpublish the newer version:
    powershell
    CopyEdit
    Unpublish-NAVApp -ServerInstance <ServerInstanceName> -Name "<AppName>" -Version 1.0.0.1
    3. Reinstall the Older Version
    Now, publish and install the older version again:
    powershell
    CopyEdit
    Publish-NAVApp -ServerInstance <ServerInstanceName> -Path "<PathToApp.1.0.0.0.app>"

    Sync-NAVApp -ServerInstance <ServerInstanceName> -Name "<AppName>" -Version 1.0.0.0 -Mode Sync

    Install-NAVApp -ServerInstance <ServerInstanceName> -Name "<AppName>" -Version 1.0.0.0

    ⚠️ Important Notes
    • This works only if your table schema changes are backward-compatible (e.g., fields were added, not renamed or deleted).
    • Any fields introduced in 1.0.0.1 and then removed will result in orphaned data in SQL unless you handle cleanup manually.
    • For production rollback, always validate your process in a sandbox first.

    Alternative (Safer): Deploy Fix in a New Version
    If rollback seems risky, create a new version (e.g., 1.0.0.2) that:
    • Removes the problematic fields.
    • Keeps the app at the latest version.
    • Maintains data continuity and avoids version downgrade errors.

    Let me know if you need the exact commands for AL extension packaging or tenant-specific deployment.
  • Suggested answer
    Jainam M. Kothari Profile Picture
    12,116 Super User 2025 Season 2 on at
  • Suggested answer
    Khushbu Rajvi. Profile Picture
    18,998 Super User 2025 Season 2 on at
    Extension Rollback.
    In Business Central SaaS, you can't downgrade an extension version directly. To roll back without losing data, create a new version (e.g., v1.0.0.2) with the same code as your original version (v1.0.0.0) but with a higher version number, and remove the unwanted fields. This lets you simulate a rollback safely without uninstalling the extension or deleting data, as SaaS only allows upgrades—not downgrades.
     

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

Quick Links

Responsible AI policies

As AI tools become more common, we’re introducing a Responsible AI Use…

Andrés Arias – Community Spotlight

We are honored to recognize Andrés Arias as our Community Spotlight honoree for…

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

#1
Sohail Ahmed Profile Picture

Sohail Ahmed 2,689 Super User 2025 Season 2

#2
Sumit Singh Profile Picture

Sumit Singh 2,631

#3
Jeffrey Bulanadi Profile Picture

Jeffrey Bulanadi 2,212

Last 30 days Overall leaderboard

Featured topics

Product updates

Dynamics 365 release plans