{"id":2626,"date":"2026-01-24T11:11:32","date_gmt":"2026-01-24T11:11:32","guid":{"rendered":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/?p=2626"},"modified":"2026-02-05T05:28:10","modified_gmt":"2026-02-05T05:28:10","slug":"kivicare-migration-rollback-guide-v4-0-0","status":"publish","type":"post","link":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/kivicare-lite\/documentation\/migration\/kivicare-migration-rollback-guide-v4-0-0\/","title":{"rendered":"KiviCare Migration &amp; Rollback Guide (v4.0.0)"},"content":{"rendered":"<div class=\"nolwrap\">\n<p>This article explains how to <strong>migrate to the latest KiviCare version (4.0.0)<\/strong> and how to <strong>rollback to an older version<\/strong> if needed.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>IMPORTANT: Take a Full Backup Before Updating<\/strong><br><\/h2>\n\n\n\n<p>Before upgrading KiviCare to a new version, <strong>it is strongly recommended to take a complete backup of your website<\/strong>.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" \/>\n\n\n\n<h4 class=\"wp-block-heading\"><strong>\ud83d\udd10\u00a0What Should Be Backed Up?<\/strong><\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li>WordPress database<\/li>\n\n\n\n<li><code>wp-content<\/code>&nbsp;folder<\/li>\n\n\n\n<li>KiviCare plugin files<\/li>\n\n\n\n<li>Any custom code or overrides<\/li>\n<\/ul>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p>\ud83d\udca1 You can use popular backup plugins or your hosting provider\u2019s backup tool to create a full backup.<\/p>\n<\/blockquote>\n\n\n\n<p>This ensures that you can <strong>safely restore your site<\/strong> if anything goes wrong during the update or migration process.<br><\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" \/>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Migration to KiviCare 4.0.0<br><\/strong><\/h2>\n\n\n\n<p>Migrating to the latest version of KiviCare is simple and safe when proper backups are in place.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\"><strong>\ud83e\udde9\u00a0Step 1: Update KiviCare Plugin<\/strong><\/h4>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Go to&nbsp;<strong>WordPress Admin \u2192 Plugins \u2192 Installed Plugins<\/strong><\/li>\n\n\n\n<li>Find&nbsp;<strong>KiviCare \u2013 Clinic Management System<\/strong><br><\/li>\n\n\n\n<li>Click&nbsp;<strong>Update<\/strong><br><\/li>\n\n\n\n<li>Make sure the plugin version is&nbsp;<strong>4.0.0<\/strong><br><\/li>\n<\/ol>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p>KiviCare automatically prepares database migrations when the latest version is activated.<\/p>\n<\/blockquote>\n\n\n\n<h4 class=\"wp-block-heading\"><strong>\ud83d\udda5\ufe0f\u00a0Step 2: Run Database Migration<br><\/strong><\/h4>\n\n\n\n<p>After updating the plugin:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Go to&nbsp;<strong>KiviCare \u2192 Dashboard<\/strong><\/li>\n\n\n\n<li>You will see a&nbsp;<strong>migration notice<\/strong>&nbsp;at the top of the dashboard<\/li>\n\n\n\n<li>Click&nbsp;<strong>Run Migrations<\/strong><\/li>\n\n\n\n<li>Wait until the migration process completes<\/li>\n<\/ol>\n\n\n\n<p>Once finished, your system is fully upgraded and ready to use \ud83c\udf89<br><\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" \/>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Migration Notes<\/strong><\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Database migrations usually run&nbsp;<strong>automatically<\/strong>&nbsp;on plugin activation<\/li>\n\n\n\n<li>If migrations remain pending, you can&nbsp;<strong>manually run them from the dashboard<\/strong><\/li>\n\n\n\n<li>The migration notice will&nbsp;<strong>disappear automatically<\/strong>&nbsp;once all migrations are completed<\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" \/>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Rollback to an Older KiviCare Version<\/strong><\/h2>\n\n\n\n<p><br>If you experience any issues after upgrading, you can rollback to a previous version of KiviCare.<\/p>\n\n\n\n<h5 class=\"wp-block-heading\"><strong>\ud83d\udce5\u00a0Step 1: Download an Older Version<\/strong><\/h5>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Visit the official WordPress plugin page:<br>\ud83d\udc49&nbsp;<a href=\"https:\/\/wordpress.org\/plugins\/kivicare-clinic-management-system\/\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/wordpress.org\/plugins\/kivicare-clinic-management-system\/<\/a><\/li>\n\n\n\n<li>Scroll down to the&nbsp;<strong>Advanced View<\/strong>&nbsp;section<\/li>\n\n\n\n<li>Find&nbsp;<strong>Previous Versions<\/strong><\/li>\n\n\n\n<li>Select the required version<\/li>\n\n\n\n<li>Click&nbsp;<strong>Download<\/strong><\/li>\n<\/ol>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"567\" src=\"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-content\/uploads\/sites\/18\/2026\/01\/old-new-advanced-view-1024x567.png\" alt=\"\" class=\"wp-image-2687\" srcset=\"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-content\/uploads\/sites\/18\/2026\/01\/old-new-advanced-view-1024x567.png 1024w, https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-content\/uploads\/sites\/18\/2026\/01\/old-new-advanced-view-300x166.png 300w, https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-content\/uploads\/sites\/18\/2026\/01\/old-new-advanced-view-768x426.png 768w, https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-content\/uploads\/sites\/18\/2026\/01\/old-new-advanced-view.png 1341w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"455\" src=\"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-content\/uploads\/sites\/18\/2026\/01\/old-select-version-1024x455.png\" alt=\"\" class=\"wp-image-2689\" srcset=\"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-content\/uploads\/sites\/18\/2026\/01\/old-select-version-1024x455.png 1024w, https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-content\/uploads\/sites\/18\/2026\/01\/old-select-version-300x133.png 300w, https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-content\/uploads\/sites\/18\/2026\/01\/old-select-version-768x341.png 768w, https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-content\/uploads\/sites\/18\/2026\/01\/old-select-version.png 1386w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<h5 class=\"wp-block-heading\"><strong>\ud83d\udd27\u00a0Step 2: Install the Older Version<\/strong><\/h5>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Go to&nbsp;<strong>WordPress Admin \u2192 Plugins<\/strong><\/li>\n\n\n\n<li><strong>Deactivate<\/strong>&nbsp;the current KiviCare plugin<\/li>\n\n\n\n<li>Click&nbsp;<strong>Add New \u2192 Upload Plugin<\/strong><\/li>\n\n\n\n<li>Upload the downloaded ZIP file<\/li>\n\n\n\n<li>Click&nbsp;<strong>Install Now<\/strong>&nbsp;and then&nbsp;<strong>Activate<\/strong><\/li>\n<\/ol>\n\n\n\n<p><\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" \/>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Rollback Notes<\/strong><\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Always keep a&nbsp;<strong>backup before rolling back<\/strong><\/li>\n\n\n\n<li>Rolling back may cause&nbsp;<strong>data or schema mismatches<\/strong><\/li>\n\n\n\n<li>Avoid rolling back on live sites without testing on a staging environment<\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" \/>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Language \/ Translation Migration Note<\/strong><\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Language files and custom translations <strong>do not migrate automatically<\/strong> during the KiviCare 4.0.0 update.<\/li>\n\n\n\n<li>If you are using a translated version of KiviCare (via <strong>Loco Translate<\/strong>, <strong>WPML<\/strong>, <strong>Polylang<\/strong>, or custom <code>.po\/.mo<\/code> files), you will need to <strong>re-sync or re-generate translations after migration<\/strong>.<\/li>\n\n\n\n<li>Plugin updates may overwrite existing language files inside the plugin directory.<\/li>\n<\/ul>\n\n\n\n<p>\u26a0\ufe0f <strong>Important:<\/strong><br>Language migration is <strong>manual<\/strong>. KiviCare does not migrate or preserve custom translations automatically during version upgrades.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" \/>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Need Help?<\/strong><br><\/h2>\n\n\n\n<p>If you face issues during migration or rollback:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Verify server requirements<\/li>\n\n\n\n<li>Check error logs<\/li>\n\n\n\n<li>Share screenshots of the migration notice<\/li>\n\n\n\n<li>Contact KiviCare support for assistance<\/li>\n<\/ul>\n\n\n\n<p>\u2705 <strong>Done!<\/strong><br>With proper backups in place, you can.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"531\" src=\"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-content\/uploads\/sites\/18\/2026\/01\/image-4-1024x531.png\" alt=\"\" class=\"wp-image-2629\" srcset=\"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-content\/uploads\/sites\/18\/2026\/01\/image-4-1024x531.png 1024w, https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-content\/uploads\/sites\/18\/2026\/01\/image-4-300x155.png 300w, https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-content\/uploads\/sites\/18\/2026\/01\/image-4-768x398.png 768w, https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-content\/uploads\/sites\/18\/2026\/01\/image-4-1536x796.png 1536w, https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-content\/uploads\/sites\/18\/2026\/01\/image-4.png 1847w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n<\/div>","protected":false},"excerpt":{"rendered":"<p>This article explains how to migrate to the latest KiviCare version (4.0.0) and how to rollback to an older version if needed. IMPORTANT: Take a Full Backup Before Updating Before upgrading KiviCare to a new version, it is strongly recommended to take a complete backup of your website. \ud83d\udd10\u00a0What Should Be Backed Up? \ud83d\udca1 You [&hellip;]<\/p>\n","protected":false},"author":12,"featured_media":0,"parent":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[72],"tags":[],"class_list":["post-2626","post","type-post","status-publish","format-standard","hentry","category-migration"],"featured_image_src":null,"author_info":{"display_name":"wordpressadminiq","author_link":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/author\/wordpressadminiq\/"},"_links":{"self":[{"href":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-json\/wp\/v2\/posts\/2626","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-json\/wp\/v2\/users\/12"}],"replies":[{"embeddable":true,"href":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-json\/wp\/v2\/comments?post=2626"}],"version-history":[{"count":7,"href":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-json\/wp\/v2\/posts\/2626\/revisions"}],"predecessor-version":[{"id":2708,"href":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-json\/wp\/v2\/posts\/2626\/revisions\/2708"}],"wp:attachment":[{"href":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-json\/wp\/v2\/media?parent=2626"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-json\/wp\/v2\/categories?post=2626"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-json\/wp\/v2\/tags?post=2626"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}