Grid2 main

What is Grid2 ?

Grid2 is a party/raid unit frame addon.

Grid2 is completely customizable. You can create new "zones" (indicators) in unit frames to show information (statuses). The indicators can be created, customized and placed anywhere. Grid2 supports several types of indicators: icon, square, text and bar. You can configure what statuses are displayed on each indicator.

Grid2 includes a huge amount of available statuses, but not all enabled be default, look through the configuration and familiarize yourself with the available options and statuses.

Grid2 is fast: consumes between 4 and 10 times less CPU cycles than other similar addons.

To open the configuration UI type "/grid2", left-click the DataBroker icon launcher or use WoW addons list window.

Grid2 components

Grid2 package includes:

  • Grid2
  • Grid2 Options
  • Grid2 Raid Debuffs
  • Grid2 Raid Debuffs Options
  • Grid2 LDB
  • Grid2 Aoe Heals

Working plugins

There are not working plugins for latest versions (but the functionality of most plugins has been included in core). Currently the only working addon plugins are:

Grid2 does not work or I think I found a bug

  • Update to the latest versions of Grid2 and the plugins listed above that you use.
  • Remove old Grid2 plugins and components. Any addon that begins with the word "Grid2" not listed above (in Grid2 components and Working plugins sections) is not compatible with current Grid2 version. Delete it from your computer.
  • Make sure you downloaded the mods WITH libs. nolib is not for you.
  • Reset your Saved Variables, pasting into chat: /script Grid2DB = nil; ReloadUI()
  • If you still get an error, go ahead and log it. Install and use the BugGrabber and BugSack mods to record the error and make it easy to cut and paste it.
  • Then, Post a ticket. Check for existing tickets about your bug first. Remember to check back on your ticket later in case we need more information.

Common issues/FAQ

Grid2 Doesn't Load after Update

If you are updating Grid2 from r560 or older version, you must reset your saved variables (you will lose all your settings), you must see a message in chat window explaining how to reset saved variables.

Raid debuffs not showing up !!!:

Raid debuffs are not enabled by default. Go to statuses -> Raid Debuffs and enable at least the Cataclysm module (if you are inside a instance you must exit and enter the instance or reload the UI after enabling the module)

I cant push the grid boxes as close together as before:

The border indicator has 2 pixels size and it has a transparent background color now. If you want the old grid2 appearance. Goto Indicators -> border -> Layout tab: Set a border size 1. And select a black and opaque background color for the border.

What about mana bars ?

Grid2 supports mana bars, but they are not created by default. If you want mana bars, create a new indicator of type "bar", place it wherever you want and map the "mana" or the "power" status to it (remember you must map some color status to the bar:color indicator too).

What is the poweralt status ?

Poweralt status is a power type (like mana/rage/energy,etc). This power type is enabled by Wow in some combats. It shows: Atremedes sound, Chog'al corruption, etc. This status is not active by default in Grid2: you must map poweralt to any compatible indicator (text or bar indicator).


Grid2 is compatible with English, Deutsch, Español, Français, Русский, 한국어, and 正體中文 game clients.

Grid2 is fully translated into English, Español and Italiano, and semi-translated into Russian, Deutsh and Français (Help would be greatly appreciated to complete localizations)


The beta versions have fairly functional preferences. Grid2 is neither complete, fully fleshed out, nor bug free.

  • The core engine is quite functional, release quality.
  • The options UI in terms of defaults is solid, and beta / release quality.
  • The options UI in terms of editing is beta / release quality
  • If this works for you then use it, if not use classic Grid.
  • For the foreseeable future the code will sometimes change in ways that require a complete reset of saved variables (SV) + UI reload. Resetting SV should be the first thing to try in case you get an error from Grid2.
  • This really is beta software. Please update to the latest versions of all Grid2 components listed above before logging a bug.
  • If you are not comfortable with an update requiring you to set things up again from scratch then you probably should use another raid frame.

What is Different

  • The focus is on performance. No more AceOO with deep call chains for example.
  • All Config is load on demand so it does not interfere with regular use of Grid2.
  • Indicators are separate from Statuses and reusable and placeable anywhere in a single grid cell.
  • Non-unique indicators (icon, square, text, etc.) can be created in whatever quantities you need.

What to Expect

Jerry wrote the core runtime. This is quite mature and functional.

Toadkiller (Azethoth) wrote an initial version of the Grid2 config. It is and will be in a primitive state for some time to come as I have joined a startup and am unlikely to do much coding. Volunteers needed.

The current version has decent and quite full featured defaults for healers. Defaults for non healers is still a work in progress.


  • The infrastructure for Status plugins is the most mature. Authors of Status plugins can port their plugins now or wait for an official beta. There is no documentation, but lots of example code in the current set.
  • It is probably possible to create Indicators at this point as well. See the Grid2IndicatorButton code for an example.
  • Other plugin types still need to be fleshed out with good examples and support code.
  • Post in the forums if you need help.

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

  • Avatar of michaelspain michaelspain Jan 19, 2015 at 22:02 UTC - 0 likes

    @j3rem1e: Go

    Unfortunately this issue cannot be fixed, the only solution is to create a standard layout using the layout editor (by group 10, etc). The game does not allow to change the layout design in combat (add, remove, resize groups, etc), so the code has to make "space" for all posible new players: 4 groups for mythic, 6 groups for flexible,etc.

  • Avatar of j3rem1e j3rem1e Jan 19, 2015 at 20:10 UTC - 0 likes

    Thanks for your update !

    two remarks, with version r746 : - when i use the layout "group with pet", grid2 take a lot of space : the layout create a row for each group, even if the group is empty. - maybe you should consider a "release" quality version : there is a lot of interesting/important stuff in the latest alpha version (like raid debuff or flex layout)

    thanks again!

  • Avatar of Tseh Tseh Jan 15, 2015 at 16:27 UTC - 0 likes

    Thanks michaelspain for fixing stuff and making new features, feels like it's christmas again.

    Only thing that I miss for current tier raiding is the shadow absorb bar for Koragh. If possible, have option for it to grow from the top/right side of the bar, to be able to use it combined with other absorbs bar.

    Thanks again for the work you put into this, really appreciate it.

  • Avatar of michaelspain michaelspain Jan 12, 2015 at 06:21 UTC - 0 likes

    @copper1956: Go

    Fixed in r743.

  • Avatar of copper1956 copper1956 Jan 11, 2015 at 15:56 UTC - 0 likes

    r742. I cannot use a layout I created in the editor in raid. It is shown in non-raid dropdowns only. PS. Health bar is ok for all 3 health update settings.

    Last edited Jan 11, 2015 by copper1956
  • Avatar of aDd1kTeD2Ka0s aDd1kTeD2Ka0s Dec 16, 2014 at 21:46 UTC - 0 likes

    Facing some major issues with the health bars not updating correctly - this has been reported HERE as well. Anyone else facing this issue and know a potential workaround?

  • Avatar of Furiant Furiant Jan 24, 2014 at 01:09 UTC - 0 likes

    I would very much like to be able to size the frames much larger (horizontally) than is currently allowed. For a 5-man party, I'd like the frames to be about 220-250 wide. Is there some technical issue that prevents this?

  • Avatar of Bitterst Bitterst Dec 16, 2013 at 09:15 UTC - 0 likes

    I've had a small issue for some time now and although it isn't huge, I was just wondering if there was a workaround.

    I'm using Clique and trying to get the context menu from right clicking a unit in a raid in Grid2. It works normally when solo or in a party. However, in a raid, the right click menu has different options (Set Focus, Promote to "Raid Leader, Assistant, Main Tank, Main Assist", Remove, Report Player for:, Cancel). Right clicking a unit in the Blizzard Raid Frame uses the same context menu as if it were your target, rather than the one Grid2 uses, which is the same as if you were to right click a player in the Raid tab of the social pane. I was hoping to reproduce the Blizzard Raid Frame functionality.

    For now, I just left click the Grid2 raid frame, and then right click my target's unit frame to do things like Add friend/Whisper/Inspect/etc, but would prefer to be able to do it without the additional step.

    I know there hasn't been any need for recent updates, so this might not be checked for a while, but thanks in advance!

  • Avatar of Immortalem Immortalem Sep 23, 2013 at 14:35 UTC - 0 likes


    I added the Buffs to the shield status but wasn't able to test it so far.

    I currently have a bar above(overlay) players heath displaying the shield(as heath bar displays health) in % of players maxHealth.

    This is what ia already used for pws and all the other shields.

    If you like you probably should be able to download my latest alpha in my repository :)

    Edit: Named it r721 even though it's no release. just sort for Alpha/Beta/release then u will find it easyly

    Last edited Sep 23, 2013 by Immortalem
  • Avatar of moodlerr moodlerr Sep 19, 2013 at 10:14 UTC - 0 likes

    Hey everyone,

    We just killed Malkorok the other day and i found the healing debuff was a little difficult to track. I use GRID2 for healing, and i was wondering if there is anyone that has managed to track the amount of healing (like you would your normal HP) using a different color as an overlay on your HP?

    This would allow me to view the shields as a normal health bar - just as a overlay in a different higlighted colour over the HP bar.

    Any help would be highly appreciated.


Date created
Oct 07, 2008
Last update
Jan 26, 2015
Development stage
  • deDE
  • enUS
  • esES
  • frFR
  • itIT
  • ruRU
zlib/libpng License
Curse link
Reverse relationships
Recent files
  • A: r749 for 6.0.3 Jan 26, 2015
  • A: r748 for 6.0.3 Jan 25, 2015
  • A: r747 for 6.0.3 Jan 25, 2015
  • A: r746 for 6.0.3 Jan 18, 2015
  • A: r745 for 6.0.3 Jan 18, 2015