{
  "id": "ft.alter",
  "title": "FT.ALTER",
  "url": "https://redis.io/docs/latest/commands/ft.alter/",
  "summary": "Adds a new field to the index",
  "tags": [
    "docs",
    "develop",
    "stack",
    "oss",
    "rs",
    "rc",
    "oss",
    "kubernetes",
    "clients"
  ],
  "last_updated": "2026-04-09T10:29:34-04:00",
  "page_type": "content",
  "content_hash": "9efa1706b935e5297a53f4022717c38cee6559378af1bff4a955f8b94b320acb",
  "sections": [
    {
      "id": "overview",
      "title": "Overview",
      "role": "overview",
      "text": "Add a new attribute to the index. Adding an attribute to the index causes any future document updates to use the new attribute when indexing and reindexing existing documents.\n\n[Examples](#examples)"
    },
    {
      "id": "required-arguments",
      "title": "Required arguments",
      "role": "content",
      "text": "<details open>\n<summary><code>index</code></summary> \n\nis index name to create. \n</details>\n\n<details open>\n<summary><code>SKIPINITIALSCAN</code></summary> \n\nif set, does not scan and index.\n</details>\n\n<details open>\n<summary><code>SCHEMA ADD {attribute} {options} ...</code></summary>\n\nafter the SCHEMA keyword, declares which fields to add:\n\n- `attribute` is attribute to add.\n- `options` are attribute options. Refer to [`FT.CREATE`]() for more information.\n\n<note><b>Note:</b>\n\nDepending on how the index was created, you may be limited by the number of additional text\nattributes which can be added to an existing index. If the current index contains fewer than 32\ntext attributes, then `SCHEMA ADD` will only be able to add attributes up to 32 total attributes (meaning that the\nindex will only ever be able to contain 32 total text attributes). If you wish for the index to\ncontain more than 32 attributes, create it with the `MAXTEXTFIELDS` option.\n</note>\n</details>"
    },
    {
      "id": "examples",
      "title": "Examples",
      "role": "example",
      "text": "<details open>\n<summary><b>Alter an index</b></summary>\n\n\n127.0.0.1:6379> FT.ALTER idx SCHEMA ADD id2 NUMERIC SORTABLE\nOK\n\n</details>"
    },
    {
      "id": "redis-software-and-redis-cloud-compatibility",
      "title": "Redis Software and Redis Cloud compatibility",
      "role": "content",
      "text": "| Redis<br />Software | Redis Cloud<br />Flexible & Annual | Redis Cloud<br />Free & Fixed | <span style=\"min-width: 9em; display: table-cell\">Notes</span> |\n|:----------------------|:-----------------|:-----------------|:------|\n| <span title=\"Supported\">&#x2705; Supported</span> | <span title=\"Supported\">&#x2705; Supported</span> | <span title=\"Supported\">&#x2705; Supported</nobr></span> |  |"
    },
    {
      "id": "return-information",
      "title": "Return information",
      "role": "returns",
      "text": "**RESP2:**\n\nOne of the following:\n* [Simple string reply](): `OK` if executed correctly.\n* [Simple error reply]() in these cases: no such index, invalid schema syntax.\n\n**RESP3:**\n\nOne of the following:\n* [Simple string reply](): `OK` if executed correctly.\n* [Simple error reply]() in these cases: no such index, invalid schema syntax."
    },
    {
      "id": "see-also",
      "title": "See also",
      "role": "related",
      "text": "[`FT.CREATE`]()"
    },
    {
      "id": "related-topics",
      "title": "Related topics",
      "role": "related",
      "text": "- [RediSearch]()"
    }
  ],
  "examples": []
}