---
title: "Maya Plugin Configuration"
url: "https://help.maxon.net/r3d/maya/en-us/Content/html/Maya%2BPlugin%2BConfiguration.html"
section_path: "Installation > Maya Plugin Configuration"
description: "The Redshift plugin binaries are located in the Redshift installation directory. The default directories for each operating system are listed below."
---

# Maya Plugin Configuration

You are here:

# Maya Plugin Configuration

## Supported versions

The Redshift plugin binaries are located in the Redshift installation directory. The default directories for each operating system are listed below.

- Windows:  `C:\Program Files\Maxon Redshift 20XX\Plugins\Maya`
- Linux:        `/usr/redshift/Plugins/Maya`
- macOS:   `/Applications/Maxon Redshift 20XX/Plugins/Maya`

Redshift supports Maya 2018, 2019, 2020, 2022, 2023, 2024, 2025, 2026, and 2027 on Windows, Linux and macOS

## Plugin Installation

### Windows

> **Note:** The Redshift installer for Windows will automatically register the Maya plugin based on the versions of Maya you selected on the *'Auto-configure Redshift plugins'* installer screen. This is done by modifying the Maya.env file for the versions of Maya that were selected.\
> The section below describes how to perform the same steps that the installer performs automatically, as well as an alternative method of registering the Maya plugin by using a module file.

The Redshift for Maya plugin installation directory includes batch files that let you perform the same registration step that are performed during installation. These batch files can be used, for example, if Maya is installed after Redshift and you wish to register the plugin *without* reinstalling Redshift.  Simply run the batch file associated with the particular version of Maya you want to register the plugin.

For example, to regsiter Redshift with Maya 2023, run the batch file  `install_redshift4maya_2023-64.bat`.

An alternative method of registering the plugin is to use a Maya module file.  Create a file named `redshift4maya.mod` containing the following text (adjust the Maya version as necessary) and place the file in one of Maya's module directories (e.g. `Documents\maya\modules`).

> **Note:** `+ MAYAVERSION:2019 redshift4maya any C:\Program Files\Maxon Redshift 20XXscripts: Plugins/Maya/Common/scriptsicons: Plugins/Maya/Common/iconsplug-ins: Plugins/Maya/2019/nt-x86-64MAYA_CUSTOM_TEMPLATE_PATH +:= Plugins/Maya/Common/scripts/NETemplatesREDSHIFT_MAYAEXTENSIONSPATH +:= Plugins/Maya/2019/nt-x86-64/extensionsREDSHIFT_PROCEDURALSPATH +:= ProceduralsREDSHIFT_COREDATAPATH :=PATH +:= bin`

### Linux

The first time you install Redshift on a system, you will need to perform an additional step so that Maya can correctly locate the plugin and script files.

This can be accomplished either by creating a Maya module file for Redshift, modifying the Maya.env file or by defining system environment variables. We recommend using a Maya module file as it requires the fewest steps as is the least prone to errors.

Create a file named `redshift4maya.mod` file in the module search path of the version(s) of Maya you are running. By default, all versions of Maya will include  `~/maya/modules` in the module search path.

A template  `redshift4maya.mod` file is included in the Redshift installation directory for reference. Simply copy  `redshift4maya.mod.template` to  `~/maya/modules/redshift4maya.mod` (create the 'modules' directory if it doesn't exist). If you have installed Redshift to an alternate location, the template will have already been customized with your alternate install location.  The  `redshift4maya.mod.template`  file from a default installation to  `/usr/redshift` is shown below.

> **Note:** `+ MAYAVERSION:2018 redshift4maya any /usr/redshift/Plugins/Mayascripts: common/scriptsicons: common/iconsplug-ins: 2018REDSHIFT_COREDATAPATH = /usr/redshiftMAYA_CUSTOM_TEMPLATE_PATH +:= common/scripts/NETemplatesREDSHIFT_MAYAEXTENSIONSPATH +:= 2018/extensionsREDSHIFT_PROCEDURALSPATH += $REDSHIFT_COREDATAPATH/procedurals+ MAYAVERSION:2017 redshift4maya any /usr/redshift/Plugins/Mayascripts: common/scriptsicons: common/iconsplug-ins: 2017REDSHIFT_COREDATAPATH = /usr/redshiftMAYA_CUSTOM_TEMPLATE_PATH +:= common/scripts/NETemplatesREDSHIFT_MAYAEXTENSIONSPATH +:= 2017/extensionsREDSHIFT_PROCEDURALSPATH += $REDSHIFT_COREDATAPATH/procedurals+ MAYAVERSION:2016.5 redshift4maya any /usr/redshift/Plugins/Mayascripts: common/scriptsicons: common/iconsplug-ins: 2016.5REDSHIFT_COREDATAPATH = /usr/redshiftMAYA_CUSTOM_TEMPLATE_PATH +:= common/scripts/NETemplatesREDSHIFT_MAYAEXTENSIONSPATH +:= 2016.5/extensionsREDSHIFT_PROCEDURALSPATH += $REDSHIFT_COREDATAPATH/procedurals+ MAYAVERSION:2016 redshift4maya any /usr/redshift/Plugins/Mayascripts: common/scriptsicons: common/icons`

### macOS

The installer for macOS automatically installs a module file for each version of Maya it detects on your system. If you have Maya installed in a non-standard location, or you install Maya *after* installing Redshift, you should copy the template module file `/Applications/Maxon Redshift 20XX/Plugins/Maya/redshift4maya.mod.template` to a location that is part of Maya's module search paths.  Note that the copy of the module template file  `redshift4maya.mod.template` should be renamed to  `redshift4maya.mod`.

For example, if you install Maya 2023 after installing Redshift, you can copy  `/Applications/Maxon Redshift 20XX/Plugins/Maya/redshift4maya.mod.template` to  `/Applictions/Autodesk/maya2023/Maya.app/Contents/modules/redshift4maya.mod`.