Updating ToxiUI

Important Notice (Read First)

The recommended and supported way to update ToxiUI is to run the ToxiUI installer on every update.
This ensures all changes, dependencies, and defaults are applied correctly.

That said, some users heavily customize their UI and prefer not to fully reset their profile every time. If you choose to selectively merge updates instead, you are doing so at your own risk. This guide documents an advanced workaround, not a replacement for the installer.

If something breaks after selectively importing modules, the first troubleshooting step will always be a full reinstall using the installer.

Example scenario:

• ToxiUI v7.2.2-beta.2
• Update affects Cooldown Text (CDM)
• You want the update without resetting your layout

Core Principle

You will:

1. Create a clean baseline profile using the installer
2. Keep that profile untouched
3. Copy only the updated modules into your existing profile

Step-by-Step Guide

1. Run the ToxiUI Installer

Launch the ToxiUI installer as usual.

2. Create a Clean Baseline Profile

When prompted, create a new profile named:

ToxiUI - Defaults Copied!

This profile must remain clean and unchanged.
Its sole purpose is to act as a reference for future updates.

❗ Never customize this profile.
❗ Never play on it.
❗ Never tweak it “just a little.”

3. Match Installer Options Exactly

Go through the installer using the same options you originally used for your existing profile (role, layout, features, etc.).

This reduces the risk of importing unexpected changes later.

4. Switch Back to Your Existing Profile

After the installer completes:

• Open ElvUI
• Switch back to your existing profile
• Make sure it is the active profile

This is the profile you will merge updates into.

5. Open Module Copy

Navigate to:

ElvUI Settings → Profiles → Module Copy

This tool allows copying individual modules or sub-modules between profiles.

6. Select the Source Profile

From the Profile dropdown, select:

ToxiUI - Defaults Copied!

This tells ElvUI where the updated settings come from.

7. Select Only the Updated Modules

Choose only the modules that were changed in the update.

For this example:

• Cooldown Text
  • cdmanager

⚠️ Importing extra modules can overwrite your custom settings.

8. Import the Settings

Click Import to copy the selected module settings into your existing profile.

9. Confirm the Import

You’ll see a confirmation popup warning that settings will be copied from the defaults profile into your current profile.

Identifying What to Import (Changelog Example)

ToxiUI changelogs explicitly state which modules were changed.

Example:

ElvUI: Style CDM cooldown text

That tells you exactly what to import:

• Cooldown Text → cdmanager

Final Notes & Warnings

• This workflow is not beginner-friendly
• Support will always prioritize full installer resets

If you experience issues after merging modules:

1. Run the ToxiUI installer again
2. Reset to a fresh profile
3. Confirm the issue still exists