Vortex Mod Manager

Installing and setting up Vortex Mod Manager, the recommended way to install, manage, and upgrade mods.

Summary

Last documented update: January 20th, 2026 by minnierylands

Windows 10 or higher is required to use Vortex mod manager. If you are not using Windows, see our Manual Install page.

Vortex is a multi-game mod manager developed for and by NexusMods, the website where most Cyberpunk 2077 mods are hosted. Here you can download mods manually or with Vortex and keep track your download history.

To use Vortex, you need an account there. If you don't have one, you can sign up here – don't worry, it's free.

Why do I need this?

Technically speaking, you don't. You can install mods manually or use Mod Organizer 2 (but without our support, sorry, choom).

However, Vortex for Cyberpunk is the most beginner-friendly way of managing your mods and will save you a lot of hassle.

If you have PTSD from modding Skyrim or Fallout with Vortex, be assured that Vortex for Cyberpunk is integrated extremely well. Go ahead, give it a try!

If you run into issues with Vortex that aren't addressed in this guide, you can contact Nexus support or join our Discord and find (volunteer) help in the #vortex-support channel.

TL;DR

Your staging folder must be on the same drive as your game installation
Your staging folder must be separate from your game install directory
Vortex has a lot of options. If you put wrong options, mods can go brr.

Download

Once you're signed in on Nexus, it's time to download Vortex Mod Manager.

If you can download it on your own, you can skip to the Install or Setup section of this guide.

Click this link, it will take you directly to the download page
Select the "Manual Download" option on the first entry:

You'll now see a download page. If you don't have Nexus Premium:
1. Select "Slow Download"
2. Wait through the five seconds cooldown
Optional, depending on your browser:
- Select your download location for files that you don't want to keep
Wait until the installer is downloaded

Nice, now the installer should be downloaded! You can proceed with the steps in the next section.

Installation

This guide will assume that you install Vortex to C:\Program Files\Black Tree Gaming Ltd\Vortex. You can install it whereever you want, but then you need to adjust accordingly.

Run the installer by double-clicking it.
If Windows shows you a prompt now, select yes — you want the setup to make changes on your device, it's supposed to install Vortex.
Click through the setup and finish its instructions!

Congrats! You've finished installation! Vortex should launch automatically and you can now move onto setup.

Setup

Here is where we get into the weeds, the particulars of Vortex setup before we can use it.

If you can setup Vortex on your own, skip to the Settings section of this guide. (Why are you reading this?)

Logging In To Nexusmods

If you are already logged in, proceed to the next section "Adding Cyberpunk"

If Vortex didn't open by itself, open it from the start menu
Log into Nexusmods by clicking on the red circle in the top right of your client

You will see either a browser window or an error message that Vortex couldn't open one – in this case, copy the URL in the box at the bottom and open the browser window yourself

Optional: Log into Nexusmods (if you aren’t already)
Allow Vortex to access your Nexus account by clicking "Authorize":

Click "Log in to Vortex":

Instead of the red icon, you should now see your profile picture and username from nexusmods.

Vortex: Adding Cyberpunk

This section will tell you how to add Cyberpunk to Vortex's managed games.

On the sidebar on the left side of your dashboard, click "Games"
In the page that now shows, type "Cyberpunk" into the search bar
Hover over its thumbnail and click "Manage"
You will now see a popup complaining about "Game support not installed". Don't panic, this is expected!

Important Note: Downloading The Cyberpunk Extension

As of January 2026, downloading the Cyberpunk Vortex Extension through Vortex itself will not download the latest version. It will download the previous version, which has an unfortunate bug.

For now, you will have to manually download the extension. Check below to see how!

You can download the Cyberpunk 2077 Vortex Extension here. The link should take you straight to the FILES tab.
Click Manual download - this will download it straight to your computer.

Currently, the Mod manager download button is not functioning as expected. You need to click Manual download

Navigate to Vortex and find the Extensions tab on the left side of the window.

On the Extensions page, you should see a box at the bottom that says Drop File(s) - you need to take the Cyberpunk Extension .zip file you just downloaded and drop it into this box.

Your Vortex extension should now be installed, and should say 0.12.1 in the Version column.

You need to restart Vortex – agree to the prompt if there is one. If not, manually close Vortex and re-open it.
Optional: If Vortex was able to auto-detect your game install, you are done now and can proceed with the Settings section.
Vortex will tell you that it couldn't detect your game install and prompt you to set it manually. Click "Continue".
In the explorer window that now pops up, navigate to the folder containing your Cyberpunk exe (e.g. C:\Games\Cyberpunk 2077\bin\x64)
Once you are in the right folder, click "Select Folder"

Vortex can now manage your game! Proceed to the next section, Settings.

Settings

This section tells you how to set the recommended settings in Vortex, grouped by tab. If a tab isn't covered, there are no recommendations and you can do what you like.

Start by clicking "Settings" in the left sidebar of your Vortex Dashboard, then select the first tab.

Interface -> Customization

This section controls how Vortex looks and behaves. If this is your first time using Vortex, just leave it at the defaults and scroll down to "Automation".

Interface -> Advanced

Interface -> Automation

The settings here tell Vortex what to do with your mods as it gets them.

Here's a screenshot of the recommended settings with an explanation below:

To put a mod in the game, Vortex requires you to complete four steps. The folders for these are configured in the Mods section.

Downloading: Putting the mod into Vortex's download cache, either by clicking the button on Nexus or by dragging-and-dropping an archive onto the client. The archive will now live in Vortex's download directory.
Installing: Unpacks the mod and copies it to Vortex's staging directory.
Enabling: This mod should be included in the next deploy
Deploying: The mod has been copied from Vortex's staging directory to your Cyberpunk game directory.

Deploy mods when Enabled

Automatically deploys each mod as you enable it, merging step 3 and 4. We recommend enabling this, as it saves you a click.

Install Mods when downloaded

Automatically completes step 2 when you download a mod. We recommend disabling this as it lets you address issues and popup one after the other

Enable Mods when installed

Automatically completes step 2 when you install a mod. We recommend enabling this, as it saves you a click.

Run Vortex when my computer starts

Starts Vortex with Windows - disable or enable at your discretion

In theory, you can configure Vortex so that you hit the download button on the website and it will download, install, enable and deploy for you. The downside with that is that you might not notice errors as they pop up in the background, which is why we recommend doing that one single click by yourself.

V2077 Settings

This toggle says "(NOT recommended)" for a reason. Do NOT enable it.

This setting controls the automatic REDmod conversion. In general, you do not want this.

It will convert all of your "legacy" mods into REDmod format, and has a habit of breaking a lot of them in the process.

For a full explanation of what that means, give this a read.

Vortex Extension Bug

In the 0.12.0 version of the Cyberpunk 2077 Vortex Extension, a bug was introduced that would enable this toggle without warning.

Thankfully, version 0.12.1 of the extension has squashed that bug, but Vortex will not automatically acknowledge the new version. You can get version 0.12.1 here.

How can I check my extension version?

In Vortex, there's an "Extensions" tab on the left hand side. Click it.

Check what it says under "Version" for the "Cyberpunk2077" extension.

If it says 0.12.1, you're good to go!

If not, you'll need to manually update it.

Click "Manual Download" on the top file from the extension's download page.
Go back to your Vortex "Extensions" page
Drop the zip you just downloaded into the box that says "Drop File(s)"

The old version (0.12.0) should now be disabled. Click "Remove" on the old extension.
You need to go back into your "V2077" settings and turn the toggle off!
Go to your "Mods" page in Vortex, press CTRL + A on your keyboard (you may need to click on one of your enabled mods first)
A bar should pop up at the bottom. Click "Reinstall". It shouldn't take too long!

You should now be free of the autoconvert bug.

Mods

This section controls Vortex file storage. It's mostly a matter of personal preference and disk space availability on your end.

Mods: Staging

This folder

must be on the same drive as your game installation, or deploy will fail
must not be your game install directory

Where Vortex keeps its mods, ready to deploy them into the Cyberpunk game directory.

The default folder location is {USERDATA}\{GAME}\mods, which resolves to C:\Users\YourUsername\AppData\Roaming\Vortex\cyberpunk2077\mods

You can keep it as this, or you can make a folder for it in a place you can easily access it, like C:\Games\Mods. Wherever you decide, you want to make sure it is accessible and you can remember it in case of issue.

Mods: Download

Where Vortex stores downloaded archives. Can be wherever you like, even on a different drive.

We recommend keeping an extra folder in there for manually downloaded mods, as Vortex can manage these as well – you just have to drag-and-drop them into the client.

Dashboard

Finally, we will return to our dashboard.

No matter what settings you chose in interface, you should still have a section labeled "Tools", where at this point you should at least see four things, the last of which will be disabled:

It can be helpful here to toggle "Enable Toolbar" above it so that you can always see them wherever you are in Vortex.

These are different options to launch the game via Vortex.

Click on the three dots next to "Launch Game with REDmods Enabled" and set it as primary. This will make Vortex pick this option when you click on the Cyberpunk 2077 picture on the far left.

"REDmod Deploy Latest Load Order" is also incredibly useful if your mods are acting up: Just using the "deploy" button on the main management page can fail – by using this button, you can debug your REDmod deployment.

Installing mods

This section will teach you how to install mods. Keep reading!

You can browse different mod collections on Nexus, but caution: collections tend to be outdated or abandoned.

Collections require constant upkeep, and most collection makers just don't do that.

You can use collections as a reference list, though. Just download the mods you want individually; that way you definitely have the latest versions of them all.

Mod Manager Download

On Nexus, you download mods from the FILES tab on mod pages.

When you open a mod's page, make sure to read the description first; most mod authors will give detailed instructions for how to download, which optional files are available, and what to expect in game.

Since you're using a mod manager, you get to use the handy Mod manager download button! Since you've linked your Nexus account, clicking this will send the files straight to Vortex. It doesn't get much easier than this.

Don't download anything just yet - we'll get to that next moment, promise!

Installing the Core Mods

The game should always be able to launch with just the core mods enabled. If it doesn't, head over to the troubleshooting page and make sure that you can launch and start a new game.

Check if you have an up-to-date version of the core mods. Outdated collections can include earlier versions. If you update them, there's a good chance that everything will work.

The following mods are requirements for many other Cyberpunk mods. We recommend you install their latest version and keep them up-to-date, since you will run into them sooner or later.

The Core Mods:

For more information on the core mods, check Core Mods explained

Some mods that depend on redscript may say they require cybercmd, but it's unnecessary to install.RED4ext performs the same functionality (and more).

Let's download Cyber Engine Tweaks together, and then you can repeat the same process for the other mods listed above!

Find The Mod

First, you need to go to the Cyber Engine Tweaks mod page. You'll see this page many times as you download mods, with their own information, content, and requirements. Make sure to check them!

The Files Tab

Now, we need to go to the FILES tab, next to the DESCRIPTION tab on the mod page.

Download The Mod

Now that you're on the FILES tab, you'll see a section that says Main Files - this is where the file you need to download lives.

Navigate to the top file listed and click the Mod manager download button.

Most downloads will have a pop-up box at this point with a list of required mods - this is to remind you to download them!

It's good practice to check the Requirements tab on the Description page before you download mods!

Cyber Engine Tweaks doesn't have any requirements, so it won't pop up this time, but it will for most other mods!

There will be a pop-up - cilck Slow Download. This will give a short timer before your mod begins downloading.

Back To Vortex

Sometimes, Vortex will bring up a screen saying a mod may need manual adjustment, or that there was an unexpected file layout.

Make sure to read these pop-ups, as they usually tell you exactly what the issue is!

If you ever get one that you're not sure about, or it just leaves you confused, head on over to our Discord and someone will help you figure it out!

Now, if you kept the default Bring Vortex to foreground when starting downloads in browser setting enabled, Vortex should pop up on your screen. If you turned that setting off, you can click on Vortex.

There should now be a 1 next to Downloads on the left side of Vortex!

Start The Game

If you left the Vortex settings as default, the mod should already be enabled and deployed!

If you changed any of these settings, you'll have to click Enable button on the mod in the Mods tab, and then the icon of a linked chain along the top bar to Deploy it.

Before you start the game, check the bell in the top right corner next to your profile picture. Click it to expand the notifications. What you want to see is all green or blue.

Any red or orange issues will need to be resolved before starting your game.

If all went well, you should see a prompt to bind an overlay key for Cyber Engine Tweaks (CET)! (If it does not, check here).

You can assign whatever you like, this button will hide or unhide the CET overlay.

This means everything is working, and you've successfully installed your first mod!

Download The Other Core Mods

Now that you've downloaded and successfully installed Cyber Engine Tweaks, you know how to download the other core mods!

To make life easier, you can click the links below to take you straight to the mod pages!

If you get stuck, go back over the steps above with the mod you're trying to download - it gets easier the more you do it.

Manual Download

Sometimes, you'll go to download a mod and won't see the Mod manager download button. Mod authors sometimes disable mod manager integration for a variety of reasons.

In these cases, you'll need to click Manual download and add the mod to Vortex yourself. Usually, Vortex can handle these files just fine – if not, it will complain about it, and loudly so.

It may seem odd to manually download a mod and then still put it into your mod manager, but it's to make your life easier in the future.

Mixing manual and mod manager downloads is not recommended, and can make potential troubleshooting way harder than it needs to be.

Let's download a mod that only allows for manual download and add it to Vortex, so you can get used to the steps involved. Don't worry, it's not too different from what you're used to already!

This guide assumes you have also followed the Mod Manager Downloadguide - it's important as it lays the groundwork for installing mods through Vortex!