Custom State Header

The Custom State Header in Bartender4 allows you to control the paging and the visibility of bars by using any macro conditions supported by WoW.


The syntax of the custom conditions is very similar to the syntax of Macros. You can use all conditions supported by the macro system to build a very complex state driver, or a very simple one, whatever suits your needs.

The General Syntax for both state drivers is:
[condition:value]parameters;[more conditions]parameters; fallback-parameters

For a complete list of the supported conditions, see Cogwheels Macro Guide

Be aware that those conditions are parsed Left-to-Right, and the first matching condition is used, so keep the order of your conditions in mind.

The Stance/Paging Header

The state header used for the paging/stances simply uses the number of your target page as the parameter. That is, 1-10 for the target bars/pages, and 0 for "do not page", so use the default page for the specific bar.

Note: Page 11 is a very special case and only used for the possess bar. ([possessbar]11 is the full code for possess bar support)


Simple State Driver for Druids. Switches to Bar 8 for Prowl, 7 for Cat, 9 for Bear and also supports the Possess Bar, with fallback to its default bar


State Driver that switches to Bar2 if you target a friendly target, and stays on its default bar for enemys


Driver that switches to Bar6 if you hold the ALT key, 7 if you hold CTRL, no paging otherwise


If you think you wrote a useful state string and want to share it with others, please contact me and i can put it up here.

The Visibility Header

The visibility state driver supports 3 differen parameters. A simple set of show and hide, but additionaly also fade to set the bar to fade-out in the selected state.

Fade Out

By specifying fade as the target you can get the bar to fade out until you place your mouse over it.

By default, it will use the Fade Out Alpha configured in the options, however you can pass another alpha value to the fade target delimited by a colon.
0 would be completely transparent, 100 completely opaque.


Fade bar out-of-combat, and show it fully in combat:


Hide Bar in every stance except 3, but only show it faded during combat


Fade Out with different alpha values


If you think you wrote a useful state string and want to share it with others, please contact me and i can put it up here.

[1]: Cogwheels Macro Guide - Conditions

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of Quakes69 Quakes69 Jun 30, 2015 at 05:52 UTC - 0 likes

    I know this is an OLD thread and yet it came in handy for me being new to WoW. Coming from a console user here are my settings.

    This setup uses the paging in Custom Conditionals

    First you'll need a few mods. Bartender4 (Of Course!) ButtonFacade(Purely just for skinning) All visual settings you can do on your own.

    Bar 1 and bar 2 will be our main focus. You can leave the others out till you setup your buttons if you wish. Or leave them Disabled! You're going to want to leave them disabled anyways after you're done.

    Slide Bar 1 down to where you want it. I have mine in the bottom middle. Slide the Bar 2 above Bar 1. The others can be where ever. I put them 1, 3, 5 together and 2, 4, 6 together. on top of one another. After I moved all my buttons.

    Bar 1: State configuration settings

    • Enabled: CHECK
    • Use Custom Condition: CHECK
    • Custom Conditions: [bar:1]1;[bar:2]3;[bar:3]5;5
    • ACCEPT

    Bar 2: General Settings

    • Enabled: CHECK - Enable Bar

    State configuration settings

    • Enabled: CHECK
    • Use Custom Condition: CHECK
    • Custom Conditions: [bar:2]4;[bar:4]6;[bar:6]6;2
    • ACCEPT

    Now you can page through 2 sets of bars at a time. Giving you access to 72 buttons with just a flip. More if you enable other buttons. I set this up with xPadder with an xBox 360 Controller. I remapped Key Bindings on WoW also. I just wish I could lock that dang right click mouse button and unlock it when I need it. Hope this helps.

    Thanks, Quake

    Edit: After moving from WofLK to MoP I noticed some changes in BT4

    IF The above doesn't work for some reason try this.

    Game Menu -to- Interface -to- ActionBars

    • Enabled: Bottom Left Bar
    • Enabled: Bottom Right Bar
    • Enabled: Right Bar
    • Okay

    Bartender4 Settings Same as above but different Code.

    Bar 1: State configuration settings

    • Enabled: CHECK
    • Use Custom Condition: CHECK
    • Custom Conditions: [bar:1]1;[bar:2]3;5
    • ACCEPT

    Bar 2: General Settings

    • Enabled: CHECK - Enable Bar

    State configuration settings

    • Enabled: CHECK
    • Use Custom Condition: CHECK
    • Custom Conditions: [bar:2]4;[bar:4]6;2
    • ACCEPT

    Thanks! Test: Hold Shift scroll mouse Wheel

    Last edited Aug 02, 2015 by Quakes69
  • Avatar of nidanone nidanone Apr 05, 2015 at 19:50 UTC - 0 likes

    Can this be used to show one set of bars of you're in one spec, and a different set of bars on the other spec?

    If not can anyone recommend the best way to show different bars depending on spec? (Without having to use a modifier key)

  • Avatar of Ztrust Ztrust Dec 11, 2014 at 02:36 UTC - 0 likes

    I have bars 9 and 10 faded out and I would like them both to show if i mouse over one is this possible ?

    Im hoping someone sees this ;)

  • Avatar of rdillman rdillman Apr 25, 2014 at 15:22 UTC - 0 likes

    Simple but useful if you have bars that you don't look at often that are hidden most of the time. This conditional shows the bar in combat, hides it otherwise, but also shows it on an alt key press:

    [combat]show; [mod:alt]show; hide
  • Avatar of ghostreeper ghostreeper Oct 30, 2013 at 09:25 UTC - 0 likes


    First love this mod so much makes a lot of button finding easy for me.

    Now for my issue

    I want to have the main action bar (bar1) change to a different bar when i change presences while playing death knight. I want it to change like it does when on my monk and I change talents and stances.

    Please help really would like to do this.

  • Avatar of NuCode NuCode Feb 03, 2012 at 08:42 UTC - 0 likes

    I am trying to do this:


    This works fine in a macro such as:

    /cast [mod]Charge;[nomod,harm]Taunt

    But in bartender it seemingly ignores the mod conditionals and only pays attention to the harm conditional... Anyone have a clue as how to fix this, or a workaround?

  • Avatar of Ghostmuzzle Ghostmuzzle Oct 06, 2011 at 05:35 UTC - 0 likes

    I just got back into playing WOW after being away for a few years. I have almost always used a version of bartender. I recently loaded bartender4, but I can not seem to get it configured the way I would like. My char is dual spec druid, the problem I am having is setting bar one, it hides just fine when I change into one of my feral forms,so I can just underlay my feral bar. The problem is I have 2 stances in cat form, each stance has certain abilities that I can't use in the other stance.

    Under my prowl form, I need to hide my cat/non-prowl form bar, your visibility tab I can not hide my cat prowl form bar. Now I have tried to do it under paging, under custom configurations to no avail. Is there a way to do this, or can you add under the visibility tab a hide when in cat/prowl form?

    For example. if I set bar one for my non feral spells, when I change to a feral form my feral abilities become visible, but when I change between my cat forms, prowl/non-prowl my other cat abilities do not hide. This is an annoyance in that if I am in prowl, if I hit one of my non prowl abilities by mistake I pop out of prowl, not a good idea in most cases, If I am in non-prowl form my other prowl buttons are visible and use up slots, this means I have to have another bar visible, taking up screen space that could be used for other things.

    Sorry for the long windedness but I just couldn't think of any other way to explain.

  • Avatar of Zerotorescue Zerotorescue Aug 05, 2011 at 15:08 UTC - 0 likes

    @Architekt: Go


    Replace "Terrorpene" with either the pet race or the pet name. The above would cause the bar to only appear when the pet named "Terrorpene" is summoned, otherwise it is faded.

  • Avatar of Architekt Architekt Mar 01, 2011 at 01:46 UTC - 0 likes

    Is there a way to make the bar change based on which warlock pet I have, like the succubus, felhunter, or voidwalker?

  • Avatar of Pimpace Pimpace Dec 18, 2009 at 02:17 UTC - 0 likes

    Can I write a complete LUA code? I need show a bar if player level below 80.


Date created
Oct 14, 2008
Last updated
Aug 29, 2012