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.
How-to guide3 min read
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
- Open Configuration › Settings and find Gravity: search by meaning.
- 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. 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.
Was this page helpful?