Version 1.3

  • Blizzard removed guild experience so the features that reported on guild XP contributions have been removed.


Alts is an addon that allows you to setup main-alt relationships and have that information displayed in various areas. It uses the LibAlts library to share data with other addons. For a list of other addons using LibAlts, see here.


Main/Alt information is displayed:

  • When that character logs on
  • When you do a /who on that character
  • In unit tooltips
  • From a command line interface
  • From a GUI interface

Main/Alt information can be set and managed:

  • By right-clicking on a unit frame
  • From a command line interface
  • From a GUI interface
  • LDB launcher to bring up the GUI interface
  • Minimap button to bring up the GUI interface

Command line options:

  • alts <searchterm> - Brings up the main window. If search term is provided, it will use it to search the main-alt data.
  • setmain <alt> <main> - Adds the specified alt as an alt of the specified main.
  • delalt <alt> <main> - Deletes the specified alt for the specified main.
  • getalts <main> - Gets the list of alts for the specified main.
  • getmain <alt> - Gets the main for the specified alt.

Automated Guild Import

Alts will automatically scan the guild notes for a character who is in a guild. It the notes are in a certain format it will then store the main/alt information into a separate area from the main-alt data that a user enters. Every time the player logs onto a character in that guild, the guild main/alt data will be updated. This information is kept separate from main/alt data a user enters so it can be easily sync'd.

The following guild note formats work:

  • <main name>'s alt
  • Alt of <main name>
  • ALT: <main name>
  • AKA: <main name>
  • (<main name>) Must be at the start of the note though.
  • [<main name>] Must be at the start of the note though.
  • <main name> alt
  • <main name>
  • ALT(<main name>)

The matching is not case sensitive. If a note with one of those formats is found and the main name is in the guild, then it will create a main/alt link.

The guild imported data and user-entered data are merged automatically when displayed or searched. The guild imported data cannot be modified from the user interface. The UI ignores edits to that data since all changes are performed only on user-entered data.

Guild Export

You can now export your guild roster in a comma-separated format (CSV). You can find this feature in the options under Guild.

  • Fields to Export: You can choose which fields to export. The fields are in the order of the checkboxes on the export screen. The Alts field will add a field that lists all the alts for the character.
  • Escape?: You can choose if the appropriate fields are escaped using double quotes. If some of the fields such as the notes have commas then you may want to try this option.
  • Only Mains: This option will export all character in the roster who are not marked as an alt.
  • Only Guild Alts: This option controls if the Alt field lists all alts you have defined or only alts defined by the guild notes. If you have setup alt relationships outside the guild notes and do not want them in the export, leave it checked. If you want all alts listed then uncheck it.

After you click Export, you can use Ctrl-A then Ctrl-C to copy the data in the export box to the clipboard. If you're using a Mac, use Command-A then Command-C. From the clipboard, you can paste the exported data into the target application.

Guild Log

Alts now takes a snapshot of your guild at logon and will report any changes at each logon. You can also bring up the log manually in the options menu under Guild. It does not monitor the guild roster while you are playing so it should not affect performance.

Friend/Ignore Logging

Alts also takes snapshows of your friends and ignore lists and displays any removed friends or ignores at logon. This is helpful because the default UI does not indicate names for characters that were deleted, renamed, etc. It does not monitor these lists while you are playing so it should not affect performance.

Enhancements or Bugs

If you want to report a bug or ask for an enhancement, feel free to submit a ticket:

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

  • Avatar of talryn1 talryn1 May 26, 2016 at 21:43 UTC - 0 likes

    @jtrack3d: Go

    I will look at your suggestions. I have been busy but I'm starting to work on updating addons for Legion.

    You should probably submit these and any other ideas as tickets. That provides better tracking for me and you. It is much harder to work with the comments. The link to submit tickets is at the bottom of the addon description, although maybe I should have put it near the top so people see it.

    I would submit each separate idea as a ticket. That way it is easier to discuss and track each idea. Some may not be doable.

    Last edited May 26, 2016 by talryn1
  • Avatar of jtrack3d jtrack3d May 24, 2016 at 15:13 UTC - 0 likes

    Hey again, love Alts and Guild Search.

    One of the most time consuming things I do is set the ALT: note. There is another competing add-on List Roster that just arrived but their format is different.

    One thing that I would love to see is the ability for the add-on to help me get a new character setup. In our guild, a main gets MM-DD-YY (date joined) or ALTS: <main> format.

    What I'd like to see is, for character that have no "note", the ability to suggest mains based on achievement points or something. Then, I could just click "possible mains" search and it would list all toons with about the same number of points... likely only one.

    I always ask, if they are available, but if I had a menu popup it would save time typing the name and putting in the special characters if they have them which is difficult.

    Also, we are a connected realm, so for us, those on same realm are Name, and those on the other realm are Name-Realm or Alts doesn't find them. Having a pop-up set the name would reduce errors.

  • Avatar of talryn1 talryn1 Nov 06, 2010 at 21:08 UTC - 0 likes

    I don't know if I would use that but it may be useful for people who like that. It is possible to auto-determine it and also let the user set it. It just adds that in all chat channels? I need to look into it but I don't think it would be complicated.

  • Avatar of Road_Block Road_Block Nov 06, 2010 at 12:46 UTC - 0 likes

    It's pretty much perfect for me as is now.

    I'm also not using one of the multi-featured chat addons (like Prat).

    Mainly using it to enhance the functionality of my own little addon GuildMemberStatus

    If you're looking for suggested features, there is one thing that although not essential in any way,
    might fit and pretty much complete it.

    Same as how you provide feedback about player's alts that the addon knows about for the user running it
    (on tooltip, who requests and everything to do with the chatframe)
    you could provide a minimal Identity-like functionality for players without the addon.

    Give the user the option to prepend their main name to their outgoing messages.

    I'm not sure if the added complexity is worth it
    (you'd have to check for the "(main)" pattern and skip adding another one for Alts users so there's no duplication)

    Last edited Nov 06, 2010 by Road_Block
  • Avatar of talryn1 talryn1 Nov 06, 2010 at 06:16 UTC - 0 likes

    I can add that. First one makes sense and I thought I had added that option already.

    Feel free to send feedback. I'm still trying to decide what I want the addon to do. The overall goal was to track main-alt relationships but keep it fairly lightweight. I don't run the larger chat addons which tend to include this kind of functionality. I also tried to improve the guild note import over the other chat addons.

  • Avatar of Road_Block Road_Block Nov 06, 2010 at 03:47 UTC - 0 likes

    Another small request :P

    In your AddMessage hook where you substitute the main's name if found
    (or in the function that returns it)
    could you check that the alt is not the player?

    I mean I already know who the alt's - I'm currently playing - main is.

    PS. An option to disable chatframe substitutions altogether would also be nice.

    Thanks for reading, regardless if you decide to implement :)

    Last edited Nov 06, 2010 by Road_Block
  • Avatar of Road_Block Road_Block Nov 03, 2010 at 20:06 UTC - 0 likes

    Can you please

    self:RegisterChatCommand("alts", "AltsHandler")

    on next release so we have an easy way of bringing up the main window without an LDB display / icon?

    /alts is convenient.

    Nice addon btw (will also be using the library in one of my own)



Date created
Sep 29, 2010
Last update
Aug 11, 2016
Development stage
  • enUS
All Rights Reserved
Curse link
Recent files