Boomslang 20th Anniversary Edition

Set up, charge, and customize the Razer Boomslang 20th Anniversary Edition mouse with Razer Synapse. Find DPI, lighting, macro, and safety information.
Document type
Master Guide
Model number(s)
Language
English

Read the Master Guide (PDF)

Follow the manufacturer’s safety warnings and check your exact model before using these instructions.

Razer Boomslang 20th Anniversary Edition

The Razer Boomslang 20th Anniversary Edition is a wireless gaming mouse that ships with the Razer Mouse Dock Pro for Boomslang 20th Anniversary Edition. The dock is both a magnetic wireless charging station and the wireless receiver, and it is designed to work only with the included mouse. The mouse uses Razer Optical Mouse Switches Gen-4 under its PU leather left and right buttons, a scroll wheel, two side buttons (mouse button 4 and mouse button 5), a DPI stage cycle button, and a Razer Focus Pro 45K Optical Sensor Gen-2. An underglow lighting/status indicator sits on the mouse and another on the dock.

The mouse has five default DPI stages: 400, 800, 1600 (default), 3200 and 6400. You can customize the DPI stages and the polling rate in Razer Synapse. Synapse also controls button assignments, profiles, Hypershift, lighting, power settings, surface calibration, linked games and macros.

Everyday setup takes a few tasks: connect the dock to a USB Type A port, rest the mouse on the dock to charge, slide the power switch on the underside to turn the mouse on, and install Razer Synapse on a Windows 11 (or higher) PC. This article covers each of those tasks, plus the battery indicators, safety guidelines and care.

Parts and Box Contents

Mouse Parts

LabelPart
ARazer™ Optical Mouse Switches Gen-4 (PU leather left mouse button and PU leather right mouse button)
BScroll wheel
CPTFE mouse feet
DPU leather mouse button 5
EPower switch
FRazer™ Focus Pro 45K Optical Sensor Gen-2
GDPI stage cycle button
HPU leather mouse button 4
IUnderglow lighting/status indicator

Razer Mouse Dock Pro Parts

LabelPart
JUSB Type C port
KMagnetic wireless charging surface
LUnderglow lighting/status indicator
MAnti-slip base

What Comes in the Box

  • Razer Boomslang 20th Anniversary Edition mouse
  • Razer Mouse Dock Pro for Boomslang 20th Anniversary Edition
  • 1.8m braided USB Type A to USB Type C cable
  • Important Product Information Guide

System Requirements and Registration

Requirements

The mouse system needs a USB Type A port. Razer Synapse needs Windows® 11 (or higher) and an internet connection for software installation.

Registering Your Device and Finding the Serial Number

Register the device at razerid.razer.com to get covered and unlock Razer benefits. The serial number is printed on the underside of the mouse and on the underside of the dock, at the spots marked in the “Let’s Get You Covered” diagram. A valid Proof of Purchase is required for any Limited Warranty Claim. The product page also shows a 3-year warranty badge.

Charging, Powering On, and Battery Status

Charging the Mouse

  1. Connect the provided USB Type A to USB Type C cable between a USB Type A port on your computer and the USB Type C port on the Razer Mouse Dock Pro.
  2. Rest the mouse on the dock’s magnetic wireless charging surface.
  3. Check the underglow lighting/status indicator to see the battery level.

For best results, connect the dock directly to your computer’s USB port with the provided cable. A depleted battery is fully charged in approximately 4 hours.

Battery Level Indicators

Battery LevelStatus Indicator
FullStatic Green
HighBreathing Yellow
MidBreathing Orange
LowBreathing Red

Low Battery Warning

At the critical level (default: 5%), the indicator blinks red. You can customize the low battery warning percentage in Razer Synapse.

Turning the Mouse On and Off

Use the power switch (E) on the underside of the mouse. Toggle it between the On and Off positions shown in the diagram. Install Razer Synapse when prompted, or download the installer from razer.com/synapse.

Navigating Razer Synapse

Razer Synapse is the software that configures the mouse. It requires an internet connection to install, update, access and save cloud-based features. Registering for a Razer ID account is recommended but optional. Features depend on the current version, connected devices and supported add-ons, so some options may differ from what is described here.

Toolbar Buttons

ButtonWhat It Does
MinimizeMinimizes the app to the taskbar while it keeps running in the background
MaximizeExpands the window to fill the screen; click again to restore the original size
CloseCloses all relevant tabs and terminates the application completely
Previous TabReturns to the last tab you visited
Next TabMoves forward if you recently used Previous Tab
Refresh TabReloads the current page, useful if a page isn’t displaying correctly or you want the latest content
Download UpdateAppears when there are changes to the app
MoreOpens a pop-up for your Devices, Modules, and Other Installed Apps tabs
SettingsOpens the Settings tab
ProfileOpens a pop-up with Log In, Feedback, Rate This Software, Add WiFi Device, and Exit
InfoHover to see extra information about a feature or function

Dashboard

The Dashboard subtab is an overview of Razer Synapse, with access to your Razer devices, modules and online services.

Gamer Room

The Gamer Room subtab lists devices that have the Razer Aether Light feature, where you can view and manage Gamer Room-supported devices. Its Synapse Override section lets you customize device lighting and make it react to Chroma-enabled games and Chroma Connect apps. The Controlled By Gamer Room App section shows supported devices controlled remotely by the Gamer Room app.

Devices & Modules

This subtab displays all installed modules and the modules available for installation.

Global Shortcuts

Global Shortcuts let you bind operations or Razer Synapse functions to custom key combinations from Razer Synapse-enabled device inputs. They apply across all device profiles. Only Razer Synapse-enabled device inputs are recognized.

Customizing Buttons and Profiles

Open the Razer Boomslang 20th Anniversary Edition tab, the main tab for the mouse. From here you can change button assignment, stored profiles, DPI sensitivity and polling rate. Changes under this tab are saved automatically to your local system and cloud storage.

Managing Profiles

A profile is a data storage system that keeps all your Razer device settings. The default profile name is based on your system’s name. Click the Profiles Dropdown Bar to see and switch between the device’s profiles. To add, import, rename, duplicate, export or delete a profile, press the profile’s Miscellaneous button.

Standard and Hypershift Modes

Hypershift mode is a secondary set of button assignments that is active while the Hypershift key is held down. By default, the Hypershift key is assigned to the fn key of a Razer Synapse-supported keyboard. You can also set any mouse button as a Hypershift key.

Reassigning a Button

  1. Open the Customize subtab.
  2. Click the Remap Menu button to see all current assignments, or select a specific button directly on the Customize tab.
  3. Choose one of the functions listed below.

The Customize subtab also shows a Mouse Use option with Left-handed and Right-handed choices.

Available Button Functions

FunctionWhat It Does
DefaultReturns the selected button to its original setting
Keyboard FunctionTurns the button into a keyboard function; Turbo mode can repeat the function while the button is held down
Mouse FunctionSubstitutes another mouse function (see the next table)
SensitivityAdjusts DPI with a button press (see the sensitivity table)
MacroRuns a prerecorded sequence of keystrokes and button presses; visible only when the Macro module is installed
Inter-deviceChanges the functionality of other Razer Synapse-enabled devices, such as using a Razer gaming keyboard to change the mouse’s Sensitivity Stage
Switch ProfileLoads a new set of button assignments; an on-screen notification appears whenever you switch profiles
Switch Chroma EffectSwitches between Chroma Effect Profiles in Chroma Studio; visible only when the Chroma Studio module is installed
Razer HypershiftActivates Hypershift mode as long as the button is held down
LaunchOpens an app or website; you search for an app or enter a website address
MultimediaAssigns media controls (see the multimedia table)
Windows ShortcutsAssigns a Windows shortcut command; Razer points to support.microsoft.com/kb/126449 for details
Text FunctionTypes prewritten text when the button is pressed; supports full Unicode and special symbols from character maps
DisableMakes the button unusable, for buttons you don’t want or that interfere with gaming

Mouse Function Options

OptionResult
Left ClickPerforms a left mouse click
Right ClickPerforms a right mouse click
Scroll ClickActivates the universal scrolling function
Double ClickPerforms a double left click
Scroll UpPerforms a “Scroll Up” command
Scroll DownPerforms a “Scroll Down” command
Mouse Button 4Performs a “Backward” command in most internet browsers
Mouse Button 5Performs a “Forward” command in most internet browsers
Scroll LeftPerforms a “Scroll Left” command
Scroll RightPerforms a “Scroll Right” command

Turbo mode is available on some mouse functions. It emulates repeatedly pressing and releasing the function while the button is held down.

Sensitivity Button Options

OptionResult
Sensitivity ClutchSwitches to a predefined DPI while the button is held; releasing returns to the previous sensitivity
Sensitivity Stage UpIncreases the current sensitivity by one stage
Sensitivity Stage DownDecreases the current sensitivity by one stage
On-The-Fly SensitivityHold the designated button and move the scroll wheel up or down to raise or lower the current DPI
Cycle Up Sensitivity StagesRaises the stage by one; after the highest stage, the next press returns to stage 1
Cycle Down Sensitivity StagesLowers the stage by one; after stage 1, the next press goes to the highest stage

Multimedia Options

OptionResult
Volume DownDecreases audio output
Volume UpIncreases audio output
Mute VolumeMutes the audio
Mic Volume UpIncreases microphone volume
Mic Volume DownDecreases microphone volume
Mute MicMutes the microphone
Mute AllMutes both microphone and audio output
Play / PausePlays, pauses or resumes current media playback
Previous TrackPlays the previous media track
Next TrackPlays the next media track

Performance: DPI and Polling Rate

The Performance subtab adjusts sensitivity, acceleration and polling rate.

Sensitivity and Sensitivity Stages

Sensitivity is how far the cursor travels for a given mouse movement. A higher DPI sends the cursor farther for the same movement. A sensitivity stage is a preset sensitivity value. The default stages are 400, 800, 1600 (default), 3200 and 6400, and you can create up to 5 stages. Cycle through them with the DPI stage cycle button, or with the DPI Stage Up and Down functions if you have assigned them to buttons.

Polling Rate

Select the polling rate you want from the available options. A higher polling rate means the computer receives information about the mouse’s status more often, which reduces input latency and improves pointer reaction time.

Smart Polling Rate Switcher

This feature changes the polling rate automatically when you start a game in full-screen mode.

Mouse Properties

This option opens Windows Mouse Properties, where you can change operating system settings that directly affect the mouse.

Lighting

The Lighting subtab controls the mouse and dock lighting.

Brightness

Toggle the Brightness option to turn lighting off, or use the slider to raise or lower the luminance. You can adjust the brightness of the dock and the mouse together or separately.

Switch Off Lighting

This power-saving tool turns off device lighting when your system’s display turns off, when the device has been idle for a set amount of time, or both.

Quick Effects

EffectDescriptionHow to Set Up
Audio meterLights up according to audio level with a default spectrum of colorsSelect a Color Boost level
BreathingFades in and out of the selected color(s)Select up to 2 colors or randomize colors
FireWarm colors that mimic the motion of flamesNo further customization required
ReactiveLights up when you click any mouse buttonSelect a color and a duration
Spectrum cyclingCycles between 16.8 million colors indefinitelyNo further customization required
StarlightEach LED has a chance of fading in and out at a random time and durationSelect up to 2 colors or randomize colors, and select a duration
StaticStays lit in the selected colorSelect a color
WaveLighting scrolls in the selected directionSelect a wave direction

To synchronize quick effects with other supported Razer Chroma-enabled devices, click the Chroma Sync button.

Advanced Effects

Advanced Effects lets you pick a Chroma Effect Profile for a Razer Chroma-enabled peripheral. To create your own profile, press the Launch Chroma Studio button. Some lighting effects may not be available on this device, and only other Razer devices that support the selected effect will synchronize. Indicator LEDs are not customizable.

Smart Dimming

Enable Smart Dimming to conserve battery life while the device is in Wireless Mode.

Power Settings

The Power subtab manages energy use when the mouse runs on its battery. You can also set the mouse to enter sleep mode after it has been idle for a certain amount of time. A Low Power Mode setting based on battery percentage also appears on this tab.

Surface Calibration

The Calibration subtab optimizes the sensor for your mouse surface for better tracking.

Smart Tracking

Smart Tracking sets the distance at which the sensor stops tracking when you lift the mouse, which helps avoid unwanted cursor movement. Use the Tracking Distance slider to set the vertical height at which tracking stops.

Asymmetric Cut-Off

Select Enable Asymmetric Cut-Off to set different values for the lift-off and landing distances. Test these distances thoroughly, because setting them too low may cause compatibility issues with the surface.

Linked Games

The Linked Games tab lets you add apps, view peripherals linked to apps, and search for listed apps.

Linking Apps in the Games Subtab

The Games subtab links apps to your peripherals and sorts apps alphabetically, by last played, or by most played. Apps stay listed even if they aren’t linked to a Razer device.

  1. To add an app that isn’t listed, click the Add button to search manually, or click the Scan button to search automatically. Use the Search button to find a specific game or program in the list.
  2. Click the app in the list, then select a device and its profile.

Your device then switches to the selected profile whenever you launch the app.

Linking Apps in the Devices Subtab

The Devices subtab lists your peripherals and the apps linked to each. Select a device to view, add or remove linked apps. Filter apps with the Views and Order dropdowns.

  1. To add an app, drag and drop its executable file into the box, or click the Add button to open the search window.
  2. In the search window, click Refresh to rescan installed apps, Search to find a specific game or program, or the Browse link to find the app manually.
  3. Click the tick box at the top left corner of the app.

The device then switches to the selected profile whenever you launch the app.

Macros

A macro is a set of recorded keystrokes, button presses and cursor movements that you can bind to your device and run at any time.

My Macros

The My Macros subtab is where you create, edit and organize macros. The Macro Dropdown Bar lists all macros for the device, and from there you can search for a macro, sort macros, create a new folder, or create a new macro. Selecting a macro enables options such as renaming, duplicating or deleting it. The Miscellaneous button opens options for the current macro, and the New Macro link creates and selects a new macro quickly.

Recording a Macro

  1. Create or select a macro.
  2. Optionally, click the dropdown menu button next to Record to set any of the options below.
  3. Click the Record button and perform the keystrokes, button presses and cursor movements.
  4. Click the Stop button, or press the Shortcut key, to end the session.
OptionWhat It Does
Start DelaySets a delay of 1 to 5 seconds before recording starts
Shortcut KeyAssigns a key that starts a macro recording even when Razer Synapse is in the background
Delay SettingsSets the time between each command
Mouse Movement TrackingTurns on mouse movement recording and sets conditions for how it is recorded

Editing a Macro

Select any command on the macro screen to edit it. Commands are arranged in order, with the first command at the top. The Insert menu on the left lets you add delays, keystrokes and button presses, an entire macro group, app launches, commands, typed text, and loops of commands within the macro.

Key Binds

The Key Binds subtab shows the Shortcut Keys for the selected macro. To bind a macro to a key or button without leaving the Macro tab, click the Assign Macro To Your Devices button.

Razer Synapse Settings and Feedback

Open the Settings tab with the Settings button.

Synapse Subtab Options

OptionWhat It Does
Auto LaunchConfigures the app’s startup behavior
NotificationsShows on-screen notifications even when you run full-screen apps
RecommendationsShows the latest products and features on your Dashboard based on installed devices and linked games
Tutorials ResetThe Reset button reactivates all tutorials for learning Synapse’s features
Synapse 3 Profile MigrationTransfers your device’s Profiles, Macros and Chroma Effects from Synapse 3 to the new Synapse
Device LightingChooses which app controls the lighting effects on your device

General Subtab Options

Language changes the display language of Razer Synapse. About shows the software version, the copyright statement and links to Razer’s terms of use, and gives quick access to Razer’s social communities.

Feedback Tab

Use the Feedback tab to send comments, suggestions and software problems directly to Razer. Razer notes that you can earn rewards for reporting bugs.

Safety, Comfort, and Care

Safety Guidelines

  • If you have trouble operating the device and troubleshooting does not work, unplug the device and contact the Razer hotline or go to support.razer.com.
  • Keep the mouse’s accessories out of the reach of small children to avoid accidents and injuries.
  • Don’t take apart the device, and don’t attempt to operate it under abnormal current loads. Doing so will void your warranty.
  • Keep the device away from liquid, humidity and moisture.
  • Operate the device only within 0°C (32°F) to 40°C (104°F). If the temperature exceeds this range, unplug and/or switch off the device until the temperature stabilizes at an optimal level.

Battery Warning

The mouse contains a Li-ion rechargeable battery. Battery life expectancy depends on usage. If you suspect the battery is drained, try charging it.

Caution: Don’t open, mutilate, or expose the device to conducting materials (metal), moisture, liquid, fire or heat. Doing so may cause the battery to leak or explode, resulting in personal injury. Battery life varies with usage.

Comfort Guidelines

Long periods of repetitive motion, poor peripheral placement, incorrect body position and poor habits may be associated with physical discomfort and injury to nerves, tendons and muscles. To avoid injury and keep comfortable:

  • Place your keyboard and monitor directly in front of you with the mouse next to it. Keep your elbows at your side, not too far away, and the keyboard within easy reach.
  • Adjust your chair and table so the keyboard and mouse are at or below elbow height.
  • Keep your feet well supported, your posture straight and your shoulders relaxed.
  • During gameplay, relax your wrist and keep it straight. If you repeat the same tasks, try not to bend, extend or twist your hands for long periods.
  • Don’t rest your wrists on hard surfaces for long periods. Use a wrist rest while gaming.
  • Don’t sit in the same position all day. Get up, step away from your desk, and stretch your arms, shoulders, neck and legs.

If you feel pain, numbness or tingling in your hands, wrists, elbows, shoulders, neck or back, consult a qualified medical doctor immediately.

Cleaning and Maintenance

The mouse needs minimal maintenance. Once a month, unplug the device from the computer and clean it with a soft cloth or cotton swab to prevent dirt buildup. Don’t use soap or harsh cleaning agents.

Razer recommends a premium Razer mouse mat for the best movement and control. The sensor is tuned and tested to read and track best on Razer mouse mats, and some surfaces cause undue wear on the feet that requires constant care and eventual replacement.

Warranty and Support

Register the device at razerid.razer.com. A valid Proof of Purchase is required for any Limited Warranty Claim. For the latest Limited Product Warranty terms, visit razer.com/warranty. For help, go to support.razer.com or contact the Razer hotline.

Frequently Asked Questions

How long does the Razer Boomslang 20th Anniversary Edition take to charge?

A depleted battery is fully charged in approximately 4 hours. Plug the Razer Mouse Dock Pro directly into your computer’s USB port with the provided cable and rest the mouse on the magnetic charging surface. A static green light on the underglow indicator means the battery is full.

What do the dock and mouse light colors mean?

They show the battery level. Static green means full, breathing yellow means high, breathing orange means mid, and breathing red means low. A blinking red light means the battery has reached the critical level, which defaults to 5%. You can change that warning percentage in Razer Synapse.

Can I use the Mouse Dock Pro with a different mouse?

No. The dock is both a charging station and a wireless receiver, and it is designed to work only with the included mouse. Treat the mouse and dock as a matched pair.

How do I turn the mouse on and off?

Use the power switch on the underside of the mouse and slide it between the On and Off positions. After you turn it on, install Razer Synapse when prompted, or download the installer from razer.com/synapse.

What are the DPI stages, and can I change them?

The default stages are 400, 800, 1600 (default), 3200 and 6400. Press the DPI stage cycle button on the underside to step through them. To change the values or the polling rate, open Razer Synapse, go to the Performance subtab, and adjust the stages there. You can create up to 5 stages.

What do I need to run Razer Synapse, and do I need a Razer ID?

You need Windows 11 (or higher) and an internet connection to install the software. Synapse also needs an internet connection to update, access and save cloud-based features. A Razer ID account is recommended but optional.

How should I clean the mouse, and what temperatures is it rated for?

Once a month, unplug the device from the computer and wipe it with a soft cloth or cotton swab. Don’t use soap or harsh cleaning agents. Use the device only between 0°C (32°F) and 40°C (104°F), and keep it away from liquid, humidity and moisture. If the temperature goes outside that range, unplug or switch off the device until it settles.

Follow the manufacturer’s safety warnings and check your exact model before using these instructions. Report an error.

Document information and editorial sourcing

The product instructions/information above in this page are based on the original manufacturer document.

Last updated: November 17, 2026

Find more product manuals in:

Related Razer Manuals