​ Browse rules from the Meilisearch Cloud dashboard

As your rule set grows, you need to know what is running. Before launching a new campaign, for example, you want to check which rules from the previous one are still active. The dashboard shows every rule in a table, and the API returns the same list with pagination and filters, so you can audit your rules from a script.

​ Browse rules from the Meilisearch Cloud dashboard

Open your project in the Meilisearch Cloud dashboard and select the Search rules tab. The table lists every rule with its conditions, its actions, its rank, its last update, and its state. Search the list by rule ID or description, or use Filters to narrow it down. The row toggle pauses a rule, and the icons on the right edit or delete it. Search rules list with the search field, the filters, and three rules

​ List rules on a self-hosted instance

Search rules must be turned on before you call the /dynamic-search-rules routes, otherwise Meilisearch returns an error. See Create your first rule.

cURL

curl \
  -X POST 'MEILISEARCH_URL/dynamic-search-rules' \
  -H 'Authorization: Bearer API_KEY' \
  -H 'Content-Type: application/json' \
  --data-binary '{
    "offset": 0,
    "limit": 20,
    "filter": {
      "query": "summer",
      "active": true
    }
  }'
  • offset and limit paginate the list. The defaults are 0 and 20.
  • filter.query matches the rules whose ID or description contains the words you send.
  • filter.active returns only the active rules with true, or only the paused ones with false. Omit it to return both.

Meilisearch returns the matching rules, sorted by lastUpdatedAt in descending order, so the rules changed most recently come first:

{
  "results": [
    {
      "uid": "summer-sale",
      "description": "Boost the products on sale during the summer sale",
      "lastUpdatedAt": "2026-05-28T09:25:53.295494760Z",
      "active": true,
      "conditions": {
        "time": {
          "start": "2026-06-01T00:00:00Z",
          "end": "2026-06-30T23:59:59Z"
        }
      },
      "actions": {
        "scale": [
          {
            "indexUid": "products",
            "filter": "on_sale = true",
            "weight": 1.5
          }
        ]
      }
    }
  ],
  "offset": 0,
  "limit": 20,
  "total": 1
}

To read a single rule you already know by name, send GET /dynamic-search-rules/{uid} instead. The rule comes back in the same format, ready to be edited and sent back to PATCH /dynamic-search-rules/{uid}.

​ Next steps

Pause a rule

Stop a rule without deleting it

Boost documents

Rank a selection of documents higher during a campaign

Specific behaviors

See how actions interact with filters and with each other

API reference

Full request and response shapes