KiviCare Migration & Rollback Guide (v4.0.0)

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.

---

🔐 What Should Be Backed Up?

• WordPress database
• wp-content folder
• KiviCare plugin files
• Any custom code or overrides

💡 You can use popular backup plugins or your hosting provider’s backup tool to create a full backup.

This ensures that you can safely restore your site if anything goes wrong during the update or migration process.

---

Migration to KiviCare 4.0.0

Migrating to the latest version of KiviCare is simple and safe when proper backups are in place.

🧩 Step 1: Update KiviCare Plugin

1. Go to WordPress Admin → Plugins → Installed Plugins
2. Find KiviCare – Clinic Management System
   
3. Click Update
   
4. Make sure the plugin version is 4.0.0
   

KiviCare automatically prepares database migrations when the latest version is activated.

🖥️ Step 2: Run Database Migration

After updating the plugin:

1. Go to KiviCare → Dashboard
2. You will see a migration notice at the top of the dashboard
3. Click Run Migrations
4. Wait until the migration process completes

Once finished, your system is fully upgraded and ready to use 🎉

---

Migration Notes

• Database migrations usually run automatically on plugin activation
• If migrations remain pending, you can manually run them from the dashboard
• The migration notice will disappear automatically once all migrations are completed

---

Rollback to an Older KiviCare Version

If you experience any issues after upgrading, you can rollback to a previous version of KiviCare.

📥 Step 1: Download an Older Version

1. Visit the official WordPress plugin page:
   👉 https://wordpress.org/plugins/kivicare-clinic-management-system/
2. Scroll down to the Advanced View section
3. Find Previous Versions
4. Select the required version
5. Click Download

🔧 Step 2: Install the Older Version

1. Go to WordPress Admin → Plugins
2. Deactivate the current KiviCare plugin
3. Click Add New → Upload Plugin
4. Upload the downloaded ZIP file
5. Click Install Now and then Activate

---

Rollback Notes

• Always keep a backup before rolling back
• Rolling back may cause data or schema mismatches
• Avoid rolling back on live sites without testing on a staging environment

---

Language / Translation Migration Note

• Language files and custom translations do not migrate automatically during the KiviCare 4.0.0 update.
• If you are using a translated version of KiviCare (via Loco Translate, WPML, Polylang, or custom .po/.mo files), you will need to re-sync or re-generate translations after migration.
• Plugin updates may overwrite existing language files inside the plugin directory.

⚠️ Important:
Language migration is manual. KiviCare does not migrate or preserve custom translations automatically during version upgrades.

---

Need Help?

If you face issues during migration or rollback:

• Verify server requirements
• Check error logs
• Share screenshots of the migration notice
• Contact KiviCare support for assistance

✅ Done!
With proper backups in place, you can.