# Search by meaning with Gravity

> What Gravity does, how to switch it on for an environment, finding pages by meaning in search, and spotting duplicates and related pages under Similar.

Source: https://docs.bifrostorbit.com/cms/editors/search-by-meaning/

Gravity finds pages and entries by what they mean, not only by the words in them, and in every language. Search for "warm clothes for winter" and it finds the Vinter insulated boot and the guide to layering for winter; search in German and it finds pages written in English. Content with a related meaning is pulled together, which is where the name comes from.

Gravity is included in every plan.

## Switch it on

1. Open **Configuration › Settings** and find **Gravity: search by meaning**.
2. Turn on the switch beside each environment you want, such as **Production** and **Staging**.

Switching it on needs the right to change the space's settings, which Administrators and Owners have. The space's pages and entries are then read in the background. Beside each environment you see how many entries are indexed, how many are waiting and when it last updated; a few thousand entries take a few minutes. After that, every change is picked up within a minute of saving.

**Try a search** in the same section shows what Gravity finds, as editors see it with drafts. Choose **Meaning and words**, **Meaning only** or **Words only** to compare.

**Rebuild** reads the whole environment again. You rarely need it; it helps if results look out of date after a large import. Search keeps working while it runs.

Turning Gravity off removes its index for that environment. Your content is not touched, and search goes back to words only.

## In search

Press **⌘K** (or **Ctrl+K**) and type what you are looking for. Below the pages whose words match, **By meaning (Gravity)** lists pages and entries close in meaning, with where they are and a short passage. You see drafts if your role can read them.

## Similar entries

When Gravity is on for the environment, the page editor has **Similar** in the right-hand rail. It lists:

- **Possible duplicates:** entries in the same language that say almost the same thing. Check whether one of them should go, or whether they should link to each other.
- **Related:** entries close in meaning, good candidates for links and "You may also like" lists.

Translations of the page itself are left out. Turn on **Include other languages** to look in the region's other languages too.

## On your website

Your website can use Gravity for its own search box and related content lists, through the delivery API or the SDK. A developer sets that up; see [Search by meaning](https://docs.bifrostorbit.com/cms/developers/search/). Visitors only ever see published content.

## If Gravity can't be reached

Nothing else is affected. Search goes back to matching words, **Settings** says Gravity can't be reached, and **Similar** asks you to try again shortly. Changes saved meanwhile are picked up when it is back.

## Where your content goes

Nowhere new. Gravity runs on our own servers in the EU, next to the rest of CMS Orbit, with an open model that understands many languages. Your text is not sent to another company to be searched.
