{
  "schema_version": 2,
  "id": "operate/rs/references/cli-utilities/rladmin/placement",
  "title": "rladmin placement",
  "url": "https://redis.io/docs/latest/operate/rs/references/cli-utilities/rladmin/placement/",
  "summary": "Configures the shard placement policy for a database.",
  "tags": [
    "docs",
    "operate",
    "rs"
  ],
  "last_updated": "2026-09-24T10:14:21+01:00",
  "page_type": "content",
  "content_hash": "7aa8d35a450b65d0a9f546dab6d3dc584ecd0249632dee60c0d3f8de135d006f",
  "sections": [
    {
      "id": "overview",
      "title": "Overview",
      "role": "overview",
      "text": "Configures the shard placement policy for a specified database.\n\n[code example]\n\n> [!NOTE]\n> `rladmin placement db` is deprecated and will be removed in a future version. Use [`rladmin tune db`](https://redis.io/docs/latest/operate/rs/references/cli-utilities/rladmin/tune#tune-db) with the `shards_placement` parameter instead."
    },
    {
      "id": "parameters",
      "title": "Parameters",
      "role": "parameters",
      "text": "| Parameter | Type/Value                     | Description                                                                                   |\n|-----------|--------------------------------|-----------------------------------------------------------------------------------------------|\n| db        | db:\\<id\\><br /> name           | Configures shard placement for the specified database                                         |\n| dense     |                                | Places new shards on the same node as long as it has resources                                |\n| sparse    |                                | Places new shards on the maximum number of available nodes within the cluster                 |"
    },
    {
      "id": "returns",
      "title": "Returns",
      "role": "returns",
      "text": "Returns the new shard placement policy if the policy was changed successfully. Otherwise, it returns an error.\n\nUse [`rladmin status databases`](https://redis.io/docs/latest/operate/rs/references/cli-utilities/rladmin/status#status-databases) to verify that the failover completed."
    },
    {
      "id": "example",
      "title": "Example",
      "role": "example",
      "text": "[code example]"
    }
  ],
  "examples": [
    {
      "id": "overview-ex0",
      "language": " sh",
      "code": "rladmin placement\n        db { db:<id> | <name> }\n        { dense | sparse }",
      "section_id": "overview"
    },
    {
      "id": "example-ex0",
      "language": " sh",
      "code": "$ rladmin status databases\nDATABASES:\nDB:ID  NAME       TYPE   STATUS   SHARDS   PLACEMENT    REPLICATION    PERSISTENCE    ENDPOINT                                \ndb:5   tr01       redis  active   1        dense        enabled        aof            redis-12000.cluster.local:12000         \n$ rladmin placement db db:5 sparse\nShards placement policy is now sparse\n$ rladmin status databases\nDATABASES:\nDB:ID  NAME       TYPE   STATUS   SHARDS   PLACEMENT    REPLICATION    PERSISTENCE    ENDPOINT                                \ndb:5   tr01       redis  active   1        sparse       enabled        aof            redis-12000.cluster.local:12000",
      "section_id": "example"
    }
  ]
}