Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

iTechGuides is reader-supported. When you buy through links on our site, we may earn an affiliate commission. As an Amazon Associate I earn from qualifying purchases. Learn more

To map a gaming-mouse button, open the configuration software that supports your exact model, select the mouse, choose the button-assignment screen, select the physical button, and assign a mouse action, keyboard key, or supported macro. Save the profile, activate it for the intended game, and test it there. The menu names, macro functions, profile behavior, and whether the mapping survives without the software depend on the mouse, software version, and assignment type.

What gaming-mouse button mapping changes

Button mapping replaces the default action of a physical mouse button with an input your game or application can use. Depending on the model and its software, you may assign:

  • A built-in mouse function, such as a primary, secondary, middle, forward, or back action.
  • A keyboard key or key combination, so a thumb button sends the same input as a keyboard control.
  • A multikey macro made from supported keyboard and mouse events.

The assignment is created in the mouse manufacturer’s configuration program, not in a universal Windows or macOS setting. A button that appears programmable on the hardware may still be limited by the model’s firmware or by what the software supports. Treat the exact model and software version as the source of truth.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Assignment type Typical use What to verify
Mouse function Use a side button as a standard click, middle click, forward, or back control. Whether the software exposes that function for the selected button.
Keyboard remap Send a game key such as reload, crouch, push-to-talk, or a shortcut from the mouse. That the game recognizes the selected key and that no other binding conflicts with it.
Macro Run a supported sequence of keyboard and mouse events from one press. Which event types, delays, repeat modes, and storage locations the model allows.

A game can interpret the same mapped input differently from a desktop application. For that reason, a mapping that works in a text field is not automatically proof that it will work in the game you intend to play.

#1 Best Overall
Sale
Logitech G305 Lightspeed Wireless Gaming Mouse - Black | 12,000 DPI, Lightweight, 6 Programmable Buttons, 250h Battery, On-Board Memory, Compatible with PC and Mac
  • The next-generation optical HERO sensor delivers incredible performance and up to 10x the power efficiency over previous generations, with 400 IPS precision and up to 12,000 DPI sensitivity
  • Ultra-fast LIGHTSPEED wireless technology gives you a lag-free gaming experience, delivering incredible responsiveness and reliability with 1 ms report rate for competition-level performance
  • G305 wireless mouse boasts an incredible 250 hours of continuous gameplay on just 1 AA battery; switch to Endurance mode via Logitech G HUB software and extend battery life up to 9 months
  • Wireless does not have to mean heavy, G305 lightweight mouse provides high maneuverability coming in at only 3.4 oz thanks to efficient lightweight mechanical design and ultra-efficient battery usage
  • The durable, compact design with built-in nano receiver storage makes G305 not just a great portable desktop mouse, but also a great laptop travel companion, use with a gaming laptop and play anywhere

Check compatibility before assigning anything

Start with the documentation and software for the exact mouse rather than a similarly named model. Confirm these points:

  • Software support: Install the manufacturer’s current configuration utility that recognizes your mouse. If the device is not listed, its buttons cannot be configured through that utility.
  • Operating-system support: Check that the utility and the mouse support the operating system on the computer where you will configure and use the device.
  • Assignable buttons: Some buttons may be reserved for hardware functions or profile switching and may not accept every action.
  • Action types: Verify whether the model supports mouse functions, keyboard remaps, macros, or only a subset of them.
  • Profiles: Determine how the software selects a profile for a game or program and whether the profile can be stored on the mouse.
  • Onboard memory: If you need the mapping on another computer or with the utility closed, confirm that the exact assignment type can be saved to onboard memory.

Do not infer current availability from an old product page. For example, Logitech documentation for the G600 demonstrates configurable profiles and many buttons, but that documentation alone does not establish that the model is currently sold or supported in every region.

General setup: map a button in six steps

  1. Connect and identify the mouse. Plug in the mouse or pair it as directed, open the supported configuration utility, and select the device from the device list.
  2. Open button assignments. Look for a section labeled Button Assignments, Key Assignments, Actions, Customize, or a similar term. The label changes between utilities and versions.
  3. Select the physical control. Click the on-screen representation of the side, top, or other button you want to change. Confirm that the selected control is the intended one before editing it.
  4. Choose an action. Select a mouse function, keyboard remap, or macro category that the software offers. Pick the specific key or function, or open the macro editor to build a sequence.
  5. Save the assignment. Apply or save the change to the current profile. Some utilities save immediately; others require an Apply, Save, or profile-save command.
  6. Test in the target application. Launch the game or program, make sure the profile containing the mapping is active, and test the button in a safe context. Check both the intended action and any original action you no longer want the button to perform.

If the assignment works in the configuration utility but not in the game, do not immediately recreate it. First confirm the active profile and whether the game recognizes the keyboard or mouse input selected for the mapping.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Concrete iCUE 5 remapping flow

Corsair’s documented flow for iCUE 5.14 and newer illustrates how version-specific the labels can be. The following path applies to the supported devices and software covered by that documentation:

Rank #2
Sale
Logitech G502 Hero Wired Gaming Mouse - Black | High performance, 25,600 DPI, RGB, adjustable weights, 11 programmable buttons, on-board memory, PC/Mac
  • HERO Gaming Sensor: Next generation HERO mouse sensor delivers precision tracking up to 25600 DPI with zero smoothing, filtering or acceleration
  • 11 programmable buttons and dual mode hyper-fast scroll wheel: The Logitech wired gaming mouse gives you fully customizable control over your gameplay
  • Adjustable weights: Match your playing style. Arrange up to five 3.6 g weights for a personalized weight and balance configuration
  • LIGHTSYNC technology: Logitech G LIGHTSYNC technology provides fully customizable RGB lighting that can also synchronize with your gaming (requires Logitech Gaming Software)
  • Mechanical Switch Button Tensioning: A metal spring tensioning system and metal pivot hinges are built into left and right computer gaming mouse buttons for a crisp, clean click feel with rapid click feedback
  1. Open iCUE and select the mouse.
  2. Choose Key Assignments.
  3. Add an assignment.
  4. Select the keyboard-remap action.
  5. Choose the keyboard key you want the physical mouse button to send.
  6. Save the assignment in the active profile and test it in the intended game or application.

Older iCUE releases use different screens and steps, so do not force this path onto an older installation. If a menu is missing, check the instructions for your installed version and device rather than selecting an unrelated action type.

Logitech assignments and legacy macro software

Logitech’s G502 support documentation describes assigning a mouse function, a keystroke, or a multikey macro, and it also describes onboard configuration for supported button actions. In the current utility for your device, the names of the screens may differ from the labels in that page, so use the device-specific instructions shown by the software.

Legacy Logitech Gaming Software (LGS) documentation describes macros assembled from keystrokes and mouse events. Use that editor only when LGS still supports your exact mouse; a guide written for an older utility may not apply to a newer model or operating system.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

The G502 support page also notes that its firmware-update tool is no longer maintained and directs readers to check supported devices for Logi Options+. That notice concerns the specific firmware tool. It is not evidence that every Logitech gaming-mouse configuration utility is discontinued, so verify the software listed for your model before changing tools.

Rank #3
Sale
Logitech G305 Lightspeed Wireless Gaming Mouse - White | 12,000 DPI, Lightweight, 6 Programmable Buttons, 250h Battery, On-Board Memory, Compatible with PC and Mac
  • Next-gen 12,000 DPI HERO optical sensor delivers unrivaled gaming performance, accuracy and power efficiency
  • Advanced LIGHTSPEED wireless gaming mouse for super-fast 1 ms response time and faster than wired performance
  • Ultra-long battery life gives you up to 250 hours of continuous gaming on a single AA battery
  • Lightweight mechanical design and classic shape for maximum maneuverability, durability and comfort
  • Compact, portable design with convenient built-in storage for included USB wireless receiver

Build a macro that behaves predictably

A macro is more than a renamed key binding: it is a sequence of events that the software records or assembles and then sends when you press the assigned button. Use the manufacturer’s macro editor and keep the sequence as simple as the game requires.

  1. Open the macro editor. From the button-assignment screen, choose the macro option offered for the selected button.
  2. Choose the trigger behavior. The utility may offer a press, hold, toggle, or repeat behavior. Select only a mode the model and software document.
  3. Record or insert events. Add the supported keyboard and mouse events in the order required by the application. If the editor records timing, review the recorded delays rather than assuming they are ideal.
  4. Assign the finished macro. Return to the physical-button view and attach the saved macro to that button.
  5. Test outside a critical match first. Use a practice area or low-risk context. Confirm that pressing and releasing the button produces the expected sequence and that a repeat or toggle does not continue unexpectedly.

Macro support is not uniform. One model may accept keyboard and mouse events while another limits the available event types or stores only simpler assignments. The software’s available controls, not the presence of a macro label in a generic guide, determine what you can use.

Use separate profiles for separate games

Profiles let the same physical button perform different actions in different programs. Create a profile for each game or application that needs a distinct layout, then associate it with the program using the utility’s profile mechanism.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Profile setup

  1. Create or select the profile for the game.
  2. Assign the game’s controls to the desired mouse buttons.
  3. Save the profile and configure its game or program association if the utility supports automatic switching.
  4. Launch the game and verify that the profile shown as active is the one you edited.

SteelSeries support documentation describes profiles for different games and programs and notes that side-button behavior depends on the application. This explains a common failure pattern: the mapping is correct in the editor, but a different profile is active when the game starts.

Rank #4
Sale
Razer Basilisk V3 Customizable RGB Wired Ergonomic Gaming Mouse, Black | Fastest Gaming Mouse Switch, Chroma RGB Lighting, 26K DPI Optical Sensor, 11 Programmable Buttons, HyperScroll Tilt Wheel
  • ICONIC ERGONOMIC DESIGN WITH THUMB REST — PC gaming mouse favored by millions worldwide with a form factor that perfectly supports the hand while its buttons are optimally positioned for quick and easy access
  • 11 PROGRAMMABLE BUTTONS — Assign macros and secondary functions across 11 programmable buttons to execute essential actions like push-to-talk, ping, and more
  • HYPERSCROLL TILT WHEEL — Speed through content with a scroll wheel that free-spins until its stopped or switch to tactile mode for more precision and satisfying feedback that’s ideal for cycling through weapons or skills
  • 11 RAZER CHROMA RGB LIGHTING ZONES — Customize each zone from over 16.8 million colors and countless lighting effects, all while it reacts dynamically with over 150 Chroma integrated games
  • OPTICAL MOUSE SWITCHES GEN 2 — With zero unintended misclicks these switches provide crisp, responsive execution at a blistering 0.2ms actuation speed for up to 70 million clicks

Will the mapping work when the software is closed?

Only sometimes. Onboard memory means the mouse can store some configuration, but it does not prove that every macro, profile rule, timing option, or software feature will run without the utility. Storage and playback capabilities are model- and assignment-dependent.

Situation What you can safely assume What you must test or verify
The utility shows an onboard-memory mode. At least some configuration can be written to the mouse. Whether the specific button assignment and profile are among the supported items.
A keyboard remap is saved to onboard memory. The mouse may send that key on another computer. Whether the destination computer and game recognize the key as expected.
A macro is saved to onboard memory. Nothing beyond what the exact documentation states. Whether that macro type, timing, repeat behavior, and event set are stored and replayed without the utility.
The utility is closed but the mouse remains connected. The last active software profile may continue to affect behavior on some systems. Whether the device has actually written the profile to hardware or still depends on the background utility.

After saving to onboard memory, close the configuration utility or connect the mouse to the computer where you need it and test again. If the assignment disappears, consult the exact model instructions; do not assume that a more expensive model or a larger button count guarantees broader onboard support.

How to choose a mouse for custom mappings

If your current mouse lacks the controls or software actions you need, compare capabilities rather than relying on the phrase “gaming mouse.” The most useful criteria are below.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Criterion Questions to ask Why it matters
Programmable-button count How many buttons can actually be reassigned? More physical controls allow more simultaneous game commands, but unused buttons add no benefit.
Button placement Can you reach the buttons without changing your grip or pressing the wrong control? Thumb-panel layouts suit many commands; a crowded layout may be slower or less comfortable.
Action support Are mouse functions, keyboard remaps, and macros all available? Your intended mapping may require a capability the model does not provide.
Profile behavior Can profiles be tied to games or programs, and how are they switched? Per-game layouts are practical only when profile selection is reliable.
Macro support Which event types, repeats, and timing controls are documented? Macro labels vary; the supported event set determines what can be automated.
Onboard memory Which assignments survive without the utility? This matters when you move the mouse between computers or cannot run background software.
Software and OS compatibility Does the configuration utility support your computer and the device? A programmable mouse is not useful if the utility cannot recognize it.

An MMO-style mouse with a multi-button thumb panel is a category option for readers who need many commands, but button comfort and reach are personal. Evaluate the layout with the grip and games you actually use. Logitech’s G600 documentation is an example of configurable many-button hardware; it should not be treated as proof of current retail availability.

Best Value
Sale
Redragon M612 Wired RGB Optical Gaming Mouse 8000 DPI Remapping Keys | Stable Lag-Free Connection, Redefine Keybinding Macro, Vibing Backlight, Ergonomic Grip Body Comfort
  • Pentakill, 5 DPI Levels - Geared with 5 redefinable DPI levels (default as: 500/1000/2000/3000/4000), easy to switch between different game needs. Dedicated demand of DPI options between 500-8000 is also available to be processed by software.
  • Any Button is Reassignable - 11 programmable buttons are all editable with customizable tactical keybinds in whatever game or work you are engaging. 1 rapid fire + 2 side macro buttons offer you a better gaming and working experience.
  • Comfort Grip with Details - The skin-friendly frosted coating is the main comfort grip of the mouse surface, which offers you the most enjoyable fingerprint-free tactility. The left side equipped with rubber texture strengthened the friction and made the mouse easier to control.
  • 5 Decent Backlit Modes - Turn the backlit on and make some kills in your gaming battlefield. The hyped dynamic RGB backlit vibe will never let you down when decorating your gaming space, it would be better with other Redragon accessories with lights on.
  • Fatigue Killer with Ergonomic Design - Solid frame with a streamlined and general claw-grip design offers a satisfying and comfortable gaming experience with less fatigue even though after hours of use.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Side buttons not working: a diagnostic checklist

When a side button fails, work from the device outward. The same symptom can come from an unassigned control, the wrong profile, an unsupported action, or application-specific behavior.

Symptom Likely check Next action
The mouse is absent from the configuration utility. Device recognition or unsupported software. Confirm that the utility is the one for the exact model, reconnect the mouse, and verify that the model appears before editing assignments.
The button is visible but cannot be edited. The control may not be assignable on that model or in that profile. Select the correct device and profile, then check the model’s assignment limits.
The button works in the desktop but not in the game. The game may not accept the mapped keyboard input or mouse function. Test the same input in the game’s own control settings and confirm that the intended profile is active.
The mapping works in one game but not another. Different profile or application behavior. Associate and activate the profile for the second game, then test that game’s expected input.
The mapping works with the utility open but fails after it closes. The assignment may not be stored in onboard memory. Save it using the device’s onboard-memory procedure and test the exact assignment without relying on the utility.
A legacy tutorial does not match the menus. Software-version or device mismatch. Use the current instructions for your model and installed version; do not assume an older macro editor still supports the device.

Check the active profile before rebuilding the mapping

Open the utility while the game is running and identify the profile marked active. If it is not the profile you edited, switch to the intended profile or correct the game’s association. Reassigning the button in the wrong profile will not fix an activation problem.

Check the input the game actually receives

A keyboard remap sends a keyboard input, not a special “gaming” signal. A game may ignore that key, reserve it for another action, or handle side-button input differently from the desktop. Test the selected key or mouse function in the game’s control interface and choose an input the game supports.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Check onboard behavior separately

If the mapping is needed away from the configuration computer, save it to onboard memory where the model supports that feature, disconnect or close the utility as appropriate, and test again. If only the macro fails while a simple key remap works, the distinction is evidence that the model stores those assignment types differently; consult its documentation rather than assuming the hardware is defective.

A reliable validation routine

Use this short routine whenever you create or change a mapping:

  1. Confirm the utility recognizes the exact mouse model.
  2. Confirm the physical button selected on screen matches the button you intend to press.
  3. Check the action type and the exact key, mouse function, or macro attached to it.
  4. Save the assignment to the correct profile.
  5. Verify that the profile is active for the intended game or program.
  6. Test the input in the application, not only in the configuration utility.
  7. If portability matters, save the supported configuration to onboard memory and repeat the test with the utility unavailable.

Bottom line

Successful button mapping is a three-part match: the exact mouse model, the configuration software and version, and the game’s handling of the resulting input. Assign a simple mouse function or keyboard key first, use the manufacturer’s macro editor only for supported sequences, keep per-game profiles explicit, and treat onboard memory as a capability to verify rather than a guarantee.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.