{
  "schema_version": 2,
  "id": "commands/sadd",
  "title": "SADD",
  "url": "https://redis.io/docs/latest/commands/sadd/",
  "summary": "Adds one or more members to a set. Creates the key if it doesn't exist.",
  "since": "1.0.0",
  "tags": [
    "docs",
    "develop",
    "stack",
    "oss",
    "rs",
    "rc",
    "oss",
    "kubernetes",
    "clients"
  ],
  "last_updated": "2026-07-08T12:05:04+02:00",
  "page_type": "content",
  "content_hash": "4f94dc9c413ff255631706160b157ddcf90ace6a6f9917da492f08a5bdc72f2e",
  "sections": [
    {
      "id": "required-arguments",
      "title": "Required arguments",
      "role": "content",
      "text": "<details open><summary><code>key</code></summary>\n\nThe name of the key that holds the set.\n\n</details>\n\n<details open><summary><code>member [member ...]</code></summary>\n\nOne or more members to add to the set.\n\n</details>"
    },
    {
      "id": "examples",
      "title": "Examples",
      "role": "example",
      "text": "Foundational: Add one or more members to a set using SADD (creates set if needed, ignores duplicates, returns count of new members)\n\n**Difficulty:** Beginner\n\n**Commands:** SADD, SMEMBERS\n\n**Complexity:**\n- SADD: O(1)\n- SMEMBERS: O(N)\n\n**Available in:** Redis CLI, C#, Go, Java (Asynchronous - Lettuce), Java (Reactive - Lettuce), Java (Synchronous - Jedis), JavaScript (Node.js), JavaScript (Node.js), PHP, Python, Ruby, Rust (Asynchronous), Rust (Synchronous)\n\n##### Redis CLI\n\n[code example]\n\n##### C#\n\n[code example]\n\n##### Go\n\n[code example]\n\n##### Java (Asynchronous - Lettuce)\n\n[code example]\n\n##### Java (Reactive - Lettuce)\n\n[code example]\n\n##### Java (Synchronous - Jedis)\n\n[code example]\n\n##### JavaScript (Node.js)\n\n[code example]\n\n##### JavaScript (Node.js)\n\n[code example]\n\n##### JavaScript (Node.js)\n\n[code example]\n\n##### JavaScript (Node.js)\n\n[code example]\n\n##### PHP\n\n[code example]\n\n##### Python\n\n[code example]\n\n##### Ruby\n\n[code example]\n\n##### Rust (Asynchronous)\n\n[code example]\n\n##### Rust (Synchronous)\n\n[code example]"
    },
    {
      "id": "redis-software-and-redis-cloud-compatibility",
      "title": "Redis Software and Redis Cloud compatibility",
      "role": "content",
      "text": "| Redis<br />Software | Redis<br />Cloud | <span style=\"min-width: 9em; display: table-cell\">Notes</span> |\n|:----------------------|:-----------------|:------|\n| <span title=\"Supported\">&#x2705; Standard</span><br /><span title=\"Supported\"><nobr>&#x2705; Active-Active</nobr></span> | <span title=\"Supported\">&#x2705; Standard</span><br /><span title=\"Supported\"><nobr>&#x2705; Active-Active</nobr></span> |  |"
    },
    {
      "id": "return-information",
      "title": "Return information",
      "role": "returns",
      "text": "**RESP2:**\n\n[Integer reply](../../develop/reference/protocol-spec#integers): the number of elements that were added to the set, not including all the elements already present in the set.\n\n**RESP3:**\n\n[Integer reply](../../develop/reference/protocol-spec#integers): the number of elements that were added to the set, not including all the elements already present in the set."
    }
  ],
  "examples": [
    {
      "id": "examples-ex0",
      "language": "plaintext",
      "code": "redis> SADD myset \"Hello\" \"World\"\n(integer) 2\nredis> SADD myset \"World\"\n(integer) 0\nredis> SMEMBERS myset\n1) \"Hello\"\n2) \"World\"",
      "section_id": "examples"
    },
    {
      "id": "examples-ex1",
      "language": "csharp",
      "code": "bool sAddResult1 = db.SetAdd(\"myset\", \"Hello\");\n        Console.WriteLine(sAddResult1); // >>> True\n\n        bool sAddResult2 = db.SetAdd(\"myset\", \"World\");\n        Console.WriteLine(sAddResult2); // >>> True\n\n        bool sAddResult3 = db.SetAdd(\"myset\", \"World\");\n        Console.WriteLine(sAddResult2); // >>> False\n\n        RedisValue[] sAddResult4 = db.SetMembers(\"myset\");\n        Array.Sort(sAddResult4);\n        Console.WriteLine(string.Join(\", \", sAddResult4));\n        // >>> Hello, World",
      "section_id": "examples"
    },
    {
      "id": "examples-ex2",
      "language": "go",
      "code": "sAddResult1, err := rdb.SAdd(ctx, \"myset\", \"Hello\").Result()\n\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\n\tfmt.Println(sAddResult1) // >>> 1\n\n\tsAddResult2, err := rdb.SAdd(ctx, \"myset\", \"World\").Result()\n\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\n\tfmt.Println(sAddResult2) // >>> 1\n\n\tsAddResult3, err := rdb.SAdd(ctx, \"myset\", \"World\").Result()\n\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\n\tfmt.Println(sAddResult3) // >>> 0\n\n\tsMembersResult, err := rdb.SMembers(ctx, \"myset\").Result()\n\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\n\tfmt.Println(sMembersResult) // >>> [Hello World]",
      "section_id": "examples"
    },
    {
      "id": "examples-ex3",
      "language": "java",
      "code": "CompletableFuture<Void> sadd = asyncCommands.sadd(\"myset\", \"Hello\").thenCompose(r -> {\n                System.out.println(r); // >>> 1\n                return asyncCommands.sadd(\"myset\", \"World\");\n            }).thenCompose(r -> {\n                System.out.println(r); // >>> 1\n                return asyncCommands.sadd(\"myset\", \"World\");\n            }).thenCompose(r -> {\n                System.out.println(r); // >>> 0\n                return asyncCommands.smembers(\"myset\");\n            })\n                    .thenAccept(System.out::println)\n                    // >>> [Hello, World]\n                    .toCompletableFuture();",
      "section_id": "examples"
    },
    {
      "id": "examples-ex4",
      "language": "java",
      "code": "Mono<Void> sadd = reactiveCommands.sadd(\"myset\", \"Hello\").doOnNext(r -> {\n                System.out.println(r); // >>> 1\n            }).flatMap(r -> reactiveCommands.sadd(\"myset\", \"World\")).doOnNext(r -> {\n                System.out.println(r); // >>> 1\n            }).flatMap(r -> reactiveCommands.sadd(\"myset\", \"World\")).doOnNext(r -> {\n                System.out.println(r); // >>> 0\n            }).flatMap(r -> reactiveCommands.smembers(\"myset\").collectList()).doOnNext(r -> {\n                System.out.println(r); // >>> [Hello, World]\n            }).then();",
      "section_id": "examples"
    },
    {
      "id": "examples-ex5",
      "language": "java",
      "code": "long sAddResult1 = jedis.sadd(\"myset\", \"Hello\");\n        System.out.println(sAddResult1); // >>> 1\n\n        long sAddResult2 = jedis.sadd(\"myset\", \"World\");\n        System.out.println(sAddResult2); // >>> 1\n\n        long sAddResult3 = jedis.sadd(\"myset\", \"World\");\n        System.out.println(sAddResult3); // >>> 0\n\n        Set<String> sAddResult4 = jedis.smembers(\"myset\");\n        System.out.println(sAddResult4.stream().sorted().collect(toList()));\n        // >>> [Hello, World]",
      "section_id": "examples"
    },
    {
      "id": "examples-ex6",
      "language": "javascript",
      "code": "const res1 = await client.sAdd('myset', ['Hello', 'World']);\nconsole.log(res1);  // 2\n\nconst res2 = await client.sAdd('myset', ['World']);\nconsole.log(res2);  // 0\n\nconst res3 = await client.sMembers('myset')\nconsole.log(res3);  // ['Hello', 'World']",
      "section_id": "examples"
    },
    {
      "id": "examples-ex7",
      "language": "javascript",
      "code": "const res1 = await redis.sadd('myset', 'Hello', 'World');\nconsole.log(res1); // >>> 2\n\nconst res2 = await redis.sadd('myset', 'World');\nconsole.log(res2); // >>> 0\n\nconst res3 = await redis.smembers('myset');\nconsole.log(res3); // >>> ['Hello', 'World']",
      "section_id": "examples"
    },
    {
      "id": "examples-ex8",
      "language": "javascript",
      "code": "const res1 = await client.sAdd('myset', ['Hello', 'World']);\nconsole.log(res1);  // 2\n\nconst res2 = await client.sAdd('myset', ['World']);\nconsole.log(res2);  // 0\n\nconst res3 = await client.sMembers('myset')\nconsole.log(res3);  // ['Hello', 'World']",
      "section_id": "examples"
    },
    {
      "id": "examples-ex9",
      "language": "javascript",
      "code": "const res1 = await redis.sadd('myset', 'Hello', 'World');\nconsole.log(res1); // >>> 2\n\nconst res2 = await redis.sadd('myset', 'World');\nconsole.log(res2); // >>> 0\n\nconst res3 = await redis.smembers('myset');\nconsole.log(res3); // >>> ['Hello', 'World']",
      "section_id": "examples"
    },
    {
      "id": "examples-ex10",
      "language": "php",
      "code": "$res1 = $r->sadd('myset', ['Hello', 'World']);\n        echo $res1 . PHP_EOL;\n        // >>> 2\n\n        $res2 = $r->sadd('myset', ['World']);\n        echo $res2 . PHP_EOL;\n        // >>> 0\n\n        $res3 = $r->smembers('myset');\n        sort($res3);\n        echo json_encode($res3) . PHP_EOL;\n        // >>> [\"Hello\",\"World\"]",
      "section_id": "examples"
    },
    {
      "id": "examples-ex11",
      "language": "python",
      "code": "res1 = r.sadd(\"myset\", \"Hello\", \"World\")\nprint(res1)  # >>> 2\n\nres2 = r.sadd(\"myset\", \"World\")\nprint(res2)  # >>> 0\n\nres3 = r.smembers(\"myset\")\nprint(res3)  # >>> {'Hello', 'World'}",
      "section_id": "examples"
    },
    {
      "id": "examples-ex12",
      "language": "ruby",
      "code": "res1 = r.sadd('myset', ['Hello', 'World'])\nputs res1 # >>> 2\n\nres2 = r.sadd('myset', ['World'])\nputs res2 # >>> 0\n\nres3 = r.smembers('myset')\nputs res3.inspect # >>> [\"Hello\", \"World\"]",
      "section_id": "examples"
    },
    {
      "id": "examples-ex13",
      "language": "rust",
      "code": "if let Ok(res1) = r.sadd(\"myset\", &[\"Hello\", \"World\"]).await {\n            let res1: i32 = res1;\n            println!(\"{res1}\"); // >>> 2\n        }\n\n        if let Ok(res2) = r.sadd(\"myset\", \"World\").await {\n            let res2: i32 = res2;\n            println!(\"{res2}\"); // >>> 0\n        }\n\n        if let Ok(res3) = r.smembers(\"myset\").await {\n            let res3: HashSet<String> = res3;\n            println!(\"{res3:?}\"); // >>> {\"Hello\", \"World\"}\n        }",
      "section_id": "examples"
    },
    {
      "id": "examples-ex14",
      "language": "rust",
      "code": "if let Ok(res1) = r.sadd(\"myset\", &[\"Hello\", \"World\"]) {\n            let res1: i32 = res1;\n            println!(\"{res1}\"); // >>> 2\n        }\n\n        if let Ok(res2) = r.sadd(\"myset\", \"World\") {\n            let res2: i32 = res2;\n            println!(\"{res2}\"); // >>> 0\n        }\n\n        if let Ok(res3) = r.smembers(\"myset\") {\n            let res3: HashSet<String> = res3;\n            println!(\"{res3:?}\"); // >>> {\"Hello\", \"World\"}\n        }",
      "section_id": "examples"
    }
  ]
}