diff --git a/assets/images/cloud-migration/1-new-project.png b/assets/images/cloud-migration/1-new-project.png
new file mode 100644
index 0000000000..01f26c081d
Binary files /dev/null and b/assets/images/cloud-migration/1-new-project.png differ
diff --git a/assets/images/cloud-migration/2-import-dump.png b/assets/images/cloud-migration/2-import-dump.png
new file mode 100644
index 0000000000..2341ea008b
Binary files /dev/null and b/assets/images/cloud-migration/2-import-dump.png differ
diff --git a/learn/cookbooks/migrate-self-hosted-to-cloud.mdx b/learn/cookbooks/migrate-self-hosted-to-cloud.mdx
index 524faaee5c..a71c07f93a 100644
--- a/learn/cookbooks/migrate-self-hosted-to-cloud.mdx
+++ b/learn/cookbooks/migrate-self-hosted-to-cloud.mdx
@@ -1,6 +1,11 @@
-# Migrating from a self-hosted Meilisearch install to Meilisearch Cloud
+---
+title: Migrating to Meilisearch Cloud — Meilisearch Documentation
+description: Meilisearch Cloud is the recommended way of using Meilisearch. This guide walks you through migrating Meilisearch from a self-hosted installation to Meilisearch Cloud.
+---
-This guide walks you through migrating Meilisearch from a self-hosted installation to Meilisearch Cloud. Meilisearch Cloud is the officially recommended way of using Meilisearch.
+# Migrating to Meilisearch Cloud
+
+Meilisearch Cloud is the recommended way of using Meilisearch. This guide walks you through migrating Meilisearch from a self-hosted installation to Meilisearch Cloud.
## Requirements
@@ -10,7 +15,7 @@ To follow this guide you need:
- A command-line terminal
- A Meilisearch Cloud account
-## Export a dump
+## Export a dump from your self-hosted installation
To migrate Meilisearch, you must first [export a dump](/learn/advanced/dumps). A dump is a compressed file containing all your indexes, documents, and settings.
@@ -20,50 +25,36 @@ To export a dump, make sure your self-hosted Meilisearch instance is running. Th
curl -X POST 'http://MEILISEARCH_URL:7700/dumps'
```
-Meilisearch will return a summarized task object:
-
-```json
-{
- "taskUid": 1,
- "indexUid": null,
- "status": "enqueued",
- "type": "dumpCreation",
- "enqueuedAt": "2022-06-21T16:10:29.217688Z"
-}
-```
+Meilisearch will return a summarized task object and begin creating the dump. [Use the returned object's `taskUid` to monitor its progress.](/learn/async/asynchronous_operations)
-Depending on your dataset size, this operation might take a few moments. [Use the returned `taskUid` to monitor its progress.](/learn/async/asynchronous_operations)
-
-Once the task is completed, you can find it in your project's dump directory. By default, this is `/dumps`.
+Once the task has been completed, you can find the dump in your project's dump directory. By default, this is `/dumps`.
-Instance configuration options or experimental features that can only be activated at launch are not included in dumps. Additionally, not all instance options are supported in the Cloud.
+Instance configuration options and experimental features that can only be activated at launch are not included in dumps.
-Once you have successfully migrated your data to Meilisearch Cloud, use the project overview interface to reactivate available options.
+Once you have successfully migrated your data to Meilisearch Cloud, use the project overview interface to reactivate available options. Not all instance options are supported in the Cloud.
## Create a Meilisearch Cloud project and import dump
-Navigate to Meilisearch Cloud in your browser and log in. If you don't have a Meilisearch Cloud account yet, you can create one for free.
+Navigate to Meilisearch Cloud in your browser and log in. If you don't have a Meilisearch Cloud account yet, [create one for free](https://cloud.meilisearch.com/register).
You can only import dumps into new Meilisearch Cloud projects. Create a new project by clicking on the "New project" button:
-
+
-This will launch the project creation interface. Fill in your project name, choose a server location, and select your plan. Then, click on the "Import .dump" button and select the dump file you generated in the previous step:
+Fill in your project name, choose a server location, and select your plan. Then, click on the "Import .dump" button and select the dump file you generated in the previous step:
-
+
-Meilisearch will start creating a new project and importing your data into it. This might take a few moments depending on the size of your dataset. Monitor the project creation status in the project overview page.
+Meilisearch will start creating a new project and importing your data. This might take a few moments depending on the size of your dataset. Monitor the project creation status in the project overview page.
-Meilisearch Cloud automatically generates a new master key during migration. If you were using security keys before the migration, so you need to update your application so it uses the new Meilisearch Cloud API keys.
+Meilisearch Cloud automatically generates a new master key during project creation. If you are using [security keys](/learn/security/master_api_keys), update your application so it uses the newly created Meilisearch Cloud API keys.
## Search preview
-Once your project is ready, click on its URL. This will bring you to the search preview interface, where you can type a few searches and ensure all data was migrated successfully.
-
-Congratulations, you have now migrated to Meilisearch Cloud, the officially recommended way to use Meilisearch.
+Once your project is ready, click on "Search preview" in the top bar menu. This will bring you to the search preview interface. Run a few test searches to ensure all data was migrated successfully.
-If you encountered any problems during this process, reach out to our support team on Discord.
\ No newline at end of file
+Congratulations, you have now migrated to Meilisearch Cloud, the recommended way to use Meilisearch. If you encountered any problems during this process, reach out to our support team on [Discord](https://discord.gg/meilisearch).
\ No newline at end of file