diff --git a/api-examples/function.HH.Lib.Dict.shuffle.md b/api-examples/function.HH.Lib.Dict.shuffle.md
new file mode 100644
index 000000000..98e8ed713
--- /dev/null
+++ b/api-examples/function.HH.Lib.Dict.shuffle.md
@@ -0,0 +1,11 @@
+```basic-usage.hack
+$keys = vec['k1', 'k2', 'k3', 'k4', 'k5'];
+$values = vec[1, 2, 3, 4, 5];
+$shuffled = Dict\shuffle($keys, $values);
+\print_r($shuffled);
+
+$keys = vec['k1'];
+$values = vec[1];
+$shuffled = Dict\shuffle($keys, $values);
+\print_r($shuffled);
+```
diff --git a/build/extracted-examples/api/hsl/function.HH.Lib.Dict.shuffle/basic-usage.hack b/build/extracted-examples/api/hsl/function.HH.Lib.Dict.shuffle/basic-usage.hack
new file mode 100644
index 000000000..4b1cfb658
--- /dev/null
+++ b/build/extracted-examples/api/hsl/function.HH.Lib.Dict.shuffle/basic-usage.hack
@@ -0,0 +1,21 @@
+// WARNING: Contains some auto-generated boilerplate code, see:
+// HHVM\UserDocumentation\MarkdownExt\ExtractedCodeBlocks\FilterBase::addBoilerplate
+
+namespace HHVM\UserDocumentation\Api\Hsl\FunctionHHLibDictShuffle\BasicUsage;
+
+use namespace HH\Lib\Dict;
+
+<<__EntryPoint>>
+async function _main(): Awaitable<void> {
+  \init_docs_autoloader();
+
+  $keys = vec['k1', 'k2', 'k3', 'k4', 'k5'];
+  $values = vec[1, 2, 3, 4, 5];
+  $shuffled = Dict\shuffle($keys, $values);
+  \print_r($shuffled);
+
+  $keys = vec['k1'];
+  $values = vec[1];
+  $shuffled = Dict\shuffle($keys, $values);
+  \print_r($shuffled);
+}
diff --git a/build/extracted-examples/api/hsl/function.HH.Lib.Dict.shuffle/basic-usage.hack.hhvm.expect b/build/extracted-examples/api/hsl/function.HH.Lib.Dict.shuffle/basic-usage.hack.hhvm.expect
new file mode 100644
index 000000000..162ea72db
--- /dev/null
+++ b/build/extracted-examples/api/hsl/function.HH.Lib.Dict.shuffle/basic-usage.hack.hhvm.expect
@@ -0,0 +1,12 @@
+Dict
+(
+    [3] => k4
+    [2] => k3
+    [1] => k2
+    [0] => k1
+    [4] => k5
+)
+Dict
+(
+    [0] => k1
+)