diff --git a/assets/images/cloud-index-settings/04-searchable-attributes-default.png b/assets/images/cloud-index-settings/04-searchable-attributes-default.png index 5d3e9143a4..573cf6db48 100644 Binary files a/assets/images/cloud-index-settings/04-searchable-attributes-default.png and b/assets/images/cloud-index-settings/04-searchable-attributes-default.png differ diff --git a/assets/images/cloud-index-settings/05-searchable-attributes-delete.png b/assets/images/cloud-index-settings/05-searchable-attributes-delete.png new file mode 100644 index 0000000000..28e897421f Binary files /dev/null and b/assets/images/cloud-index-settings/05-searchable-attributes-delete.png differ diff --git a/assets/images/cloud-index-settings/05-searchable-attributes-filled.png b/assets/images/cloud-index-settings/05-searchable-attributes-filled.png deleted file mode 100644 index 2e05caa029..0000000000 Binary files a/assets/images/cloud-index-settings/05-searchable-attributes-filled.png and /dev/null differ diff --git a/assets/images/cloud-index-settings/06-save.png b/assets/images/cloud-index-settings/06-save.png deleted file mode 100644 index bd8558c630..0000000000 Binary files a/assets/images/cloud-index-settings/06-save.png and /dev/null differ diff --git a/assets/images/cloud-index-settings/06-searchable-attributes-confirm-deletion.png b/assets/images/cloud-index-settings/06-searchable-attributes-confirm-deletion.png new file mode 100644 index 0000000000..a96f4192f1 Binary files /dev/null and b/assets/images/cloud-index-settings/06-searchable-attributes-confirm-deletion.png differ diff --git a/assets/images/cloud-index-settings/07-saving.png b/assets/images/cloud-index-settings/07-saving.png deleted file mode 100644 index 615188eb3a..0000000000 Binary files a/assets/images/cloud-index-settings/07-saving.png and /dev/null differ diff --git a/assets/images/cloud-index-settings/07-searchable-attributes-attribute-deleted.png b/assets/images/cloud-index-settings/07-searchable-attributes-attribute-deleted.png new file mode 100644 index 0000000000..1f8c219c74 Binary files /dev/null and b/assets/images/cloud-index-settings/07-searchable-attributes-attribute-deleted.png differ diff --git a/assets/images/cloud-index-settings/08-saved.png b/assets/images/cloud-index-settings/08-saved.png deleted file mode 100644 index 65398e8971..0000000000 Binary files a/assets/images/cloud-index-settings/08-saved.png and /dev/null differ diff --git a/assets/images/cloud-index-settings/08-searchable-attributes-reset.png b/assets/images/cloud-index-settings/08-searchable-attributes-reset.png new file mode 100644 index 0000000000..91fd4c02c4 Binary files /dev/null and b/assets/images/cloud-index-settings/08-searchable-attributes-reset.png differ diff --git a/learn/configuration/configuring_index_settings.mdx b/learn/configuration/configuring_index_settings.mdx index 86066c823e..cae713678f 100644 --- a/learn/configuration/configuring_index_settings.mdx +++ b/learn/configuration/configuring_index_settings.mdx @@ -5,11 +5,11 @@ description: This tutorial shows how to check and change an index setting using # Configuring index settings with the Meilisearch Cloud interface -This tutorial will show you how to check and change an index setting using the [Meilisearch Cloud](https://cloud.meilisearch.com/projects/?utm_campaign=oss&utm_source=docs&utm_medium=settings-tutorial) interface. +This tutorial will show you how to check and change an index setting using the [Meilisearch Cloud](https://cloud.meilisearch.com/projects/) interface. ## Requirements -- an active [Meilisearch Cloud](https://cloud.meilisearch.com/projects/?utm_campaign=oss&utm_source=docs&utm_medium=settings-tutorial) account +- an active [Meilisearch Cloud](https://cloud.meilisearch.com/projects/) account - a Meilisearch Cloud project with at least one index ## Accessing a project's index settings @@ -28,37 +28,39 @@ Using the menu on the left-hand side, click on "Attributes": ![The index configuration overview together with a menu with links to pages dedicated to various index settings.](/assets/images/cloud-index-settings/03-general-settings.png) -Scroll and look for "Searchable attributes": +The first setting is "Searchable attributes" and lists all attributes in your dataset's documents: -![The "Searchable attributes" configuration section showing the default setting value.](/assets/images/cloud-index-settings/04-searchable-attributes-default.png) +![The "Searchable attributes" configuration section showing six attributes. One of them, "id" is this index's primary key.](/assets/images/cloud-index-settings/04-searchable-attributes-default.png) -If this is a new index, you should see the default value, `["*"]`. This indicates Meilisearch looks through all document attributes when searching. +Clicking on other settings will show you similar interfaces that allow visualizing and editing all Meilisearch index settings. ## Updating a setting -All documents include a primary key attribute. In most cases, this attribute does not contain any relevant data, so you can improve your application search experience by explicitly removing it from your searchable attributes list. +All documents include a primary key attribute. In most cases, this attribute does not contain information relevant for searches, so you can improve your application's search by explicitly removing it from the searchable attributes list. -Click on the input box with the current value. Then, replace it with an array of strings containing all attributes in your index except the primary key: +Find your primary key, then click on the bin icon: -![The "Searchable attributes" configuration section showing the new setting value: \["title","author","genre","price"\].](/assets/images/cloud-index-settings/05-searchable-attributes-filled.png) +![The same "Searchable attributes" list as before, with the bin-shaped "delete" icon highlighted.](/assets/images/cloud-index-settings/05-searchable-attributes-delete.png) -Two buttons will appear on the bottom of the screen when you start editing a field. Once you're finished editing a setting, click on "Save": +Meilisearch will display a pop-up window asking you to confirm you want to remove the attribute from the searchable attributes list. Click on "Yes, remove attribute": -![The "Searchable attributes" configuration section showing two buttons at the bottom of the screen: "Cancel changes" and "Save".](/assets/images/cloud-index-settings/06-save.png) +![A pop-up window over the index settings interface. It reads: "Are you sure you want to remove the attribute id?" Below it are two buttons: "Cancel" and "Yes, remove attribute".](/assets/images/cloud-index-settings/06-searchable-attributes-confirm-deletion.png) -The button icon will change to a spinning wheel to indicate Meilisearch is processing the changes. Depending on the size of your dataset and the setting you have edited, this might take some time: +Most updates to an index's settings will cause Meilisearch to re-index all its data. Wait a few moments until this operation is complete. You are not allowed to update any index settings during this time. -![The "Searchable attributes" configuration section showing two buttons at the bottom of the screen. The "Save" button now has a spinning loading icon.](/assets/images/cloud-index-settings/07-saving.png) +Once Meilisearch finishes indexing, the primary key will no longer appear in the searchable attributes list: -Once Meilisearch is ready, the button should change to a green color. You will also see a notification pop-up on the right-hand side of your screen. +![The same "Searchable attributes" list as before. It only contains five searchable attributes after removing the primary key.](/assets/images/cloud-index-settings/07-searchable-attributes-attribute-deleted.png) -![The "Searchable attributes" configuration section showing two buttons at the bottom of the screen. The "Save" button has changed color and now reads "Saved".](/assets/images/cloud-index-settings/08-saved.png) +If you deleted the wrong attribute, click on "Add attributes" to add it back to the list. You may also click on "Reset to default", which will bring back the searchable list to its original state when you first added your first document to this index: + +![The same "Searchable attributes" list as before. Two buttons on its top-right corner are highlighted: "Reset to default" and "Add attributes".](/assets/images/cloud-index-settings/08-searchable-attributes-reset.png) ## Conclusion You have used the Meilisearch Cloud interface to check the value of an index setting. This revealed an opportunity to improve your project's performance, so you updated this index setting to make your application better and more responsive. -This tutorial used the searchable attributes setting, but the procedure is the same no matter which index setting you are editing. +This tutorial used the "Searchable attributes" setting, but the procedure is the same no matter which index setting you are editing. ## What's next diff --git a/learn/getting_started/cloud_quick_start.mdx b/learn/getting_started/cloud_quick_start.mdx index 1fb950336e..8377dd2f6c 100644 --- a/learn/getting_started/cloud_quick_start.mdx +++ b/learn/getting_started/cloud_quick_start.mdx @@ -5,7 +5,7 @@ description: Learn how to create your first Meilisearch Cloud project. # Getting started with Meilisearch Cloud -This tutorial walks you through setting up [Meilisearch Cloud](https://meilisearch.com/cloud?utm_campaign=oss&utm_source=docs&utm_medium=cloud-quick-start), creating a project and an index, adding documents to it, and performing your first search with the default web interface. +This tutorial walks you through setting up [Meilisearch Cloud](https://meilisearch.com/cloud), creating a project and an index, adding documents to it, and performing your first search with the default web interface. You need a Meilisearch Cloud account to follow along. If you don't have one, register for a 14-day free trial account at [https://cloud.meilisearch.com/register](https://cloud.meilisearch.com/register?utm_campaign=oss&utm_source=docs&utm_medium=cloud-quick-start). diff --git a/reference/api/settings.mdx b/reference/api/settings.mdx index 0dad732bec..db8ab19f3a 100644 --- a/reference/api/settings.mdx +++ b/reference/api/settings.mdx @@ -12,7 +12,7 @@ For a conceptual overview of index settings, refer to the [indexes explanation]( ## Settings interface -[Meilisearch Cloud](https://cloud.meilisearch.com/projects/?utm_campaign=oss&utm_source=docs&utm_medium=settings-reference) users can manage index settings through the indexes interface and the `/settings` route. Users hosting their own Meilisearch instance can only manage index settings through the `/settings` route. +[Meilisearch Cloud](https://meilisearch.com/cloud) offers a [user-friendly graphical interface for managing index settings](/learn/configuration/configuring_index_settings) in addition to the `/settings` route. The Cloud interface offers more immediate and visible feedback, and is helpful for tweaking relevancy when used in conjunction with the [search preview](/learn/getting_started/search_preview). ## Settings object