diff --git a/docs/led_selection.md b/docs/led_selection.md
new file mode 100644
index 0000000000..f7315cb76d
--- /dev/null
+++ b/docs/led_selection.md
@@ -0,0 +1,45 @@
+---
+layout: default
+title: Led Selection
+nav_order: 0
+parent: Menus
+grand_parent: Vortex Engine
+---
+
+# Led Selection
+
+The Color Select, Pattern Select, and Randomizer will change only the leds which were selected upon entering the menu.
+
+## How It Works
+
+The Randomizer uses intelligent algorithms based on color theory to create visually appealing and unique modes. This allows creation of coherent colorsets with an added element of randomization.
+
+## Random Seed
+The Randomizer chooses a starting point based on the mode you start from. This means that starting with the same mode will produce the same sequence of random results.
+
+For those familiar, the randomizer seed is a checksum of the current mode.
+
+## Using the Randomizer
+
+1. **Pick a Mode to Randomize**: Navigate to the mode you want to randomize and hold the button until the leds flash white
+2. **Enter the Randomizer**: Long click to enter the white menu
+3. **Pick the Leds to Randomize**: Short click to cycle through led groups, long click to select a group
+4. **Generate a New Mode**: Short click to randomize as many times as you like
+5. **Save and Exit**: Long click to save the mode and exit.
+
+## Auto Randomization
+
+While cycling through random modes in the randomizer menu, perform three consecutive short clicks to enable _Auto Cycle_ and automatically generate a new mode every few seconds. Short click to stop cycling.
+
+## Advanced Randomization
+
+See [Advanced Menus](advanced_menus.html) to enable this feature.
+
+With the _advanced randomizer_, after selecting the led group to randomize, you may choose:
+
+ - **Rainbow Ribbon**: Randomize Colorset only
+ - **White Strobe**: Randomize Pattern only
+ - **Rainbow Strobe**: Randomize both pattern & colorset
+
+Other than this extra option the _advanced randomizer_ will behave the exact same as the basic randomizer.
+
diff --git a/docs/upgrade_guide.md b/docs/upgrade_guide.md
index 261d7dcfd3..e13ce05c34 100644
--- a/docs/upgrade_guide.md
+++ b/docs/upgrade_guide.md
@@ -24,7 +24,7 @@ First, connect your device to the PC via USB.
Next, double click the reset button and a new drive should appear, this may take a few tries.
-
+