CMS Orbit
Gravity: search your content by meaning, in every language
Search for 'warm clothes for winter' and find the layering guide and the Vinter insulated boot, though neither uses those words. Gravity is on every plan.
4 min read
On this page
People search in their own words, and those are rarely the words on your pages. A visitor types 'warm clothes for winter' into the search box. The page they need is called 'Layering for winter: stay warm without sweating', and the boot they want is the Vinter insulated boot. A search that matches words finds neither.
Gravity is CMS Orbit's search by meaning. It finds pages and entries by what they mean, not only by their words, and in every language. Editors use it in the editor, your website can use it for its own search box, and AI agents can use it before they draft. Content with a related meaning is pulled together, which is where the name comes from.
On every plan
Gravity is included in every plan of CMS Orbit, and you switch it on yourself for each environment. Your content isn't touched by switching it on or off, and if Gravity can't be reached, search goes back to matching words.
What it finds
A few examples from the Northwilds space:
- Warm clothes for winter: The guide 'Layering for winter' and the Vinter insulated boot, though neither says 'warm clothes'.
- Warme Kleidung für den Winter: The same guide and boot, answered in German where there is a German version.
- A new journal post: Similar lists it as a possible duplicate of one from last year, before it goes live.
- 'You may also like' under a trip: Your website asks Gravity for the entries closest in meaning, instead of someone picking links by hand.
Switch it on
An Owner or Administrator opens Configuration › Settings, finds Gravity: search by meaning and turns it on for each environment, such as Staging and Production. That way you can try it in Staging first.
Gravity then reads the space's pages and entries in the background. A few thousand take a few minutes. Beside each environment you see how many entries are indexed, how many are waiting and when it last updated. From then on, every change is searchable within a minute of saving or publishing, and unpublished or deleted entries drop out at once.
Try a search in the same section shows what Gravity finds, as editors see it with drafts. Compare Meaning and words, Meaning only and Words only on your own content. After a large import, Rebuild reads the whole environment again while search keeps working.
In the editor
Press ⌘K or Ctrl+K and type what you're looking for. Under the pages whose words match, By meaning (Gravity) lists pages and entries close in meaning, with where they are and a short passage.
The page editor also gets Similar in the right-hand rail. For the Fjell GTX boot, it lists the Skarv mid boot, the Lyng trail shoe and the Vinter insulated boot.
- Possible duplicates: Entries in the same language that say almost the same thing, so you can merge them or link them.
- Related: Entries close in meaning, good candidates for links and 'You may also like' lists.
- Other languages: Translations of the page itself are left out. Turn on Include other languages to look in the region's other languages too.
Every language at once
A question in any language matches entries in every language the search covers, and each answer comes back in the language you asked for when there is a version. A search for 'warme Kleidung für den Winter' finds the German version of the Northwilds layering guide. A search in German also finds pages written in English.
On your website
The delivery API answers /search and /related, and the JavaScript SDK has search and related from version 0.14. Search mixes meaning and words by default, or uses either on its own, and filters by content type, tag, address and language. A request such as GET /cms/v1/search?q=warm%20clothes%20for%20winter&type=gear,journalPost returns the layering guide and the Vinter boot, each with a short snippet.
Visitors only ever see published content. Drafts need a secret key from a server, entries in the bin never appear, and a landing page only while its campaign is live. Until Gravity is on for the environment, the same calls answer with keyword results, so your developers can build the search page first.
For AI agents
Agents connected over MCP can search by meaning and check for duplicates before they draft, with the rights of the person behind them. See AI agents.
Your content stays on our servers
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 isn't sent to another company to be searched. Turning Gravity off removes its index for that environment and leaves your content as it is.
Try it
Read how Gravity works on the Gravity page. In the docs, editors start with Search by meaning with Gravity, and developers with Search by meaning. Explore CMS Orbit and start a trial, free for 14 days, then switch Gravity on in the space's settings.
Read next
One website, many countries and languages, connect AI agents to CMS Orbit and A/B testing in a headless CMS.