
Manage articulations with the MainStage Articulation Set Editor
The Articulation Set Editor consists of three panes: Articulations, Switches, and Output.
The Articulations pane
The Articulations pane is where you can define specific articulations, including their names and IDs. The articulations defined here populate the articulation menus in the plug-in header and the various editors.

You can set articulations to be triggered by MIDI channel rather than an articulation ID. This can be useful for instruments whose MIDI channels are used to control additional properties.
The Articulations pane contains a table showing the following parameters:
Name field: Type a name for your articulation in this field.
Articulation ID field: Type a number to be the Articulation ID for your articulation. For Sampler based instruments that use the articulation ID for group selection, choose the corresponding articulation ID. For any other instruments, an output transformation needs to be defined on the output page (converting the articulations back into keyswitches), and the IDs can be arbitrary.
Channel pop-up menu: Choose a MIDI channel for the articulation, or choose “-” for all MIDI channels.
Symbol pop-up menu: Choose a notation symbol to represent the articulation in the Score Editor.
Revert button: Reverts any changes done to the articulations to their saved state.
Plus and minus buttons: Use these buttons to create and remove articulations.
The Switches pane
The Switches pane is where you create and customize keyswitches and controller switch assignments for each articulation. You can determine the type of MIDI message to use for switches, what values within that MIDI message to use, and you can specify the articulation behavior when the switch is triggered.

It includes the following controls:
MIDI Remote button: This button has to be active for your articulation switches to respond to the defined MIDI messages. If MIDI Remote is off, you cannot control your articulation switches remotely with your attached MIDI device. For example, you might want to turn off MIDI Remote if you want to play an instrument live using the full keyboard range without risking an accidental switch between articulations.
MIDI Channel pop-up menu: Sets a specific MIDI channel for all your keyswitches. This is useful if you have a dedicated keyboard for keyswitches or you want to limit your keyswitches to a particular MIDI channel.
Octave Offset pop-up menu: Sets an offset for the octave used for keyswitches. You can set an offset of up to plus or minus ten octaves. This can be useful in particular for bass instruments; keyswitches are often set to very low octaves, with bass instruments you may want to move the keyswitches to higher octaves and leave the lower octaves free for playing.
These three controls can be set locally in the Switches pane, or globally to affect how all instruments with articulations behave. To determine if these settings are local or global, see MIDI settings in MainStage.
Below the controls is a table showing each articulation, along with the following parameters:
Type pop-up menu: Chooses the specific type of MIDI message used to activate the articulation. Note On is the standard MIDI message used to trigger articulations, but Note Off, Poly Aftertouch (polyphonic aftertouch), Controller, Program (program change), Aftertouch (monophonic aftertouch), and Pitch Bend are also supported.
Selector pop-up menu: Determines which specific value of the MIDI message chosen in the Type column triggers the articulation. For example, if you chose Note On in the Type column, here is where you would choose the specific note for the keyswitch. If you chose Controller in the Type column, you would choose the specific controller number. If you choose Program, Aftertouch, or Pitch Bend in the Type column, there will be no Selector value.
Value Start slider: Defines the low end of the range for the controller switches. For Note On/Off messages, this relates to velocity values.
Value End slider: Defines the high end of the range for the controller switches. For Note On/Off messages, this relates to velocity values.
Mode pop-up menu: Selects between different switch modes. These different switch modes exist in order to support both variations in your playing style and special articulation features.
Permanent: Switches to the selected articulation, which then is used for all subsequent notes until another articulation is selected. This is useful for the main (standard) articulations such as Sustain, Staccato, and other common playing techniques.
Permanent (Retrigger): Stops the currently sounding note and retriggers it immediately with the newly selected articulation. The new articulation is used for all the following notes until another articulation is selected.
Permanent (Trigger): Immediately applies the newly selected articulation to the currently playing note. As soon as the switch is disengaged, all notes are stopped. This is useful to trigger falls, doits, and so on, at the end of a musical phrase.
Momentary: Activates the keyswitch only while the switch is within its defined Value range. For Note On or Note Off articulations this means the articulation switches only while the key is depressed or released respectively; for controllers the articulation is selected as long as the value is within the value start and end range. This is useful for articulations you only want to use for one note or a very short passage such as growls, trills, and so on.
Momentary (Retrigger): Stops the current note and retriggers it immediately with the selected articulation while the switch is within its defined Value range. For Note On or Note Off articulations this means the articulation switches only while the key is depressed or released respectively; for controllers the articulation is selected as long as the value is within the value start and end range.
Momentary (Trigger): Immediately applies the newly selected articulation to the currently playing note while the switch is within its defined Value range. As soon as the switch is disengaged all notes are stopped. This is useful to trigger falls, doits, and so on, at the end of a musical phrase.
Toggle: Activates the selected articulation when the switch is engaged. When the switch is engaged again it reactivates the previous articulation. This is useful when you want to toggle between two articulations, such as sustained notes and palm muting.
Toggle (Retrigger): Stops the currently sounding note and retriggers it immediately with the newly selected articulation. When the switch is engaged again it reactivates the previous articulation.
Toggle (Trigger): Immediately applies the newly selected articulation to the currently playing note. As soon as the switch is disengaged all notes are stopped. This is useful to trigger falls, doits, and so on, at the end of a musical phrase.
Articulation pop-up menu: Choose the articulation for the switch. You can use the same articulation multiple times, each triggered by a different type or selector, and with different value ranges.
Revert button: Reverts any changes made to the switches to their saved state.
Plus and minus buttons: Use these buttons to create and remove the selected switch.
The Output pane
For instruments that don’t support the use of articulation IDs directly, you can use the Output pane to define how articulations are accessed in your particular instrument. Output articulations are mostly keyswitches. Some third-party sampler instruments also use controllers as switches.
Working in the Output pane, you can define output triggers for articulations, which means that you can use triggers with third-party libraries for which pre-configured Articulation Sets do not already exist. Because the output triggers are independent of the switches, they can be used to create setups with consistent switches across different libraries.

The Output pane consists of a table showing each articulation, along with the following parameters:
Name field: Displays the name of the articulation.
Type pop-up menu: Choose the specific type of MIDI message that is used to activate the articulation. Note On is the standard MIDI message used to trigger articulations, but Note Off, Poly Aftertouch (polyphonic aftertouch), Controller, Program (program change), Aftertouch (monophonic aftertouch), and Pitch Bend are also supported.
Channel pop-up menu: Choose a MIDI channel for the articulation, or choose “-” for all MIDI channels. This is useful when third-party sample libraries use specific MIDI channels for articulations.
Selector pop-up menu: Determines which specific value of the MIDI message chosen in the Type column triggers the articulation. For example, if you chose Note On in the Type column, here is where you would choose the specific note for the keyswitch. If you chose Controller in the Type column, you would choose the specific controller number.
Value Start slider: Defines the low end of the range for the controller switches.
Value End slider: Defines the high end of the range for the controller switches.
Activate Multiple Outputs checkbox: Define up to three MIDI messages that can be sent to an instrument in order to activate an articulation. This may be necessary for instruments that require, for example, one MIDI message to chose a category and another MIDI message to choose an articulation within within that category.
Revert button: Reverts any changes made to the output assignments to their saved state.