# Status

The limits you meet in OrbSearch today, each stated plainly.

OrbSearch has not had its first public version. Here is what it does not do, so no limit surprises you.

## Running it

- **No packages or images are published.** Compose builds the images from the checkout, and `@orbsearch/client` and `@orbsearch/react` are TypeScript source inside the repository's pnpm workspace.
- **One installation is one shop,** with one management key and one panel account, the owner's. There are no invitations or roles.
- **One machine.** Compose runs one of each service, without replication.

## The panel

- **The panel edits part of a [release](/docs/reference/glossary#release):** synonyms, each type's searched fields and typos, each page's filters, sorting and grid, [rules](/docs/reference/glossary#rule), banners, and how an import's columns are read.
- **The rest goes through the management API:** channels, attributes, ranking, patterns, URLs, redirects, overlays, relations and search tests, as [release files](/docs/releases#the-release-files).
- **A rule the panel's form cannot express** can only be renamed, switched on or off, or moved there.

## Search

- **Built-in language knowledge covers German and English.** The shop's own words resolve in any language, but word endings, color words, price phrases and the import's defaults know only these two. Add what is missing to [`synonyms.json`](/docs/reference/release-files/synonyms) and [`patterns.json`](/docs/reference/release-files/patterns).
- **Search tests are not run.** `tests.json` is checked with its release, but publishing does not run the tests.
- **A category's `where` is not applied.** It is checked, but a category page lists only the products the catalog assigns to it.
- **Two settings are checked but never read:** `never` in `synonyms.json` only refuses edits that would merge its words, and no search reads `relations.json`.
- **Suggested words are counted across channels,** so a brand that one channel does not sell may still be suggested there.
- **Some counts are upper bounds** where a product's variants differ. The answer marks them with `upper_bound`, and the [trace](/docs/reference/glossary#trace) says why.
- **Requests have limits:** a page holds up to 100 hits, and pages reach the first 1,000 matches. A page counts its first 30 [facets](/docs/reference/glossary#facet) and those chosen or asked for; the others come without counts until asked for. [Limits](/docs/reference/limits) lists every limit.

## Insights

- **Clicks and views only.** A storefront reports clicks and views, not purchases or added carts, so there are no conversion numbers.
- **A query reaches the reports** once two page views searched it on the same day.

## The APIs

- **Problems have no types of their own.** Every `type` is `about:blank`; tell [problems](/docs/reference/problems) apart by `status`.
- **The OpenAPI document declares no security scheme.** A generated client adds the `Authorization` header itself.
- **No MCP server.** Agents use the HTTP APIs, and in the browser `@orbsearch/client` registers the WebMCP tools `search`, `get_facets` and `set_filters` ([Agents](/docs/agents)).

## License

OrbSearch is licensed under AGPL-3.0-or-later. The contract crate, `@orbsearch/client` and `@orbsearch/react` are MIT.