SyncFriends synchronises friend list between your alts, including friend notes.


What it does...

  • monitoring friend addition & removal: add/remove a friend on an alt, he will be added/removed from other alts next time you use them
  • monitoring friend note changes: modify a friend note on an alt, that note will be updated on other alts' friend lists next time you use them
  • guild-aware: save friend list space by removing friends which are also guildmates (if you of they leave the guild, they will be added back to your friend list)
  • visible...: when SyncFriends alters your friend list, it tells you
  • ...when it should: no popups or floating text, notifications are a line in your default chat window
  • fine-grained configuration: global, per-alt and per-alt's-friend configuration levels (see the list below)
  • integrated: no custom window, SyncFriends is configured through the standard "Interface" -> "Add-on" menu entry


What it could do someday...

  • synchronise "ignore" list
  • more accessible configuration (use a table to present more options at a time)

Quick start

  • Install just as any other addon. Make sure Ace3 addon (library) is installed.
  • Connect with one of your alts, you should see the list of your friends (including your alt itself) being added to SyncFriends
    • If it does not happen, make sure "Auto-export" is enabled. See "Configuration" section below.
    • If you don't want some friends to be synchronized with your other alts, mark it for "skipping". See "Configuration" section below.
  • Add, remove friends at you convenience
  • Connect with another alt at your convenience, rinse, repeat


There are 2 ways to download SyncFriends:

  • Download release files from your favourite site. If unsure, that's probably what you want to do.
  • Fetch from repository. If, like me, you use your favourite VCS client to keep your addons up-to-date - and as such are not afraid of the occasional bug and complete lack of translation, here you go: .

Known limitations

  • If your alts have more than 100[1] unique friends, SyncFriends will not be able to synchronize them all (and will tell it when trying to add the 101[1]st). This limitation comes from Blizzard.

[1] This limitation is believed to be accurate (thanks, LaoTseu), but please PM me if you know a LUA global or getter from Blizzard scripts giving the value of this limit.

Bugs & feature requests

Please use the WowAce ticket system for bug reports & feature requests: .


There is a GUI configuration available for this addon, accessible in the Interface WoW menu.

Note: Configuration makes use of tri-state check-boxes. This allows to express 3 different intentions:

  • On mode (plain yellow tick): Option is enabled
  • Off mode (no tick): Option is disabled
  • Third-state mode (gray tick): Delegate decision to another check-box

It is composed in the following way:

  • Sync data tab: Pool content is shared among all your alts, and contains the aggregated list of your friends.
    • Sync button: Manually trigger a synchronization. Use this after you changed something in pool values below.
    • Clear button: Empty the synchronisation pool. Makes SyncFriends forget all your friends and their notes. Of course, does not remove any friend in your friend list. It will ask for confirmation before doing anything.
    • Pool content
      • Friend list: Select one of the entries to be able to configure it in the panel on the right. Your current alt is in green, your other alts are in yellow, and friends are in white.
      • Friend properties
        • Action list selection: Change scheduled action for this friend:
          • addition : Friend will be added to alt's friend list upon synchronization.
          • removal: Friend will be removed from alt's friend list upon synchronization
          • skipping: Friend will be ignored in synchronization (it won't be added to alt's friend list, nor will he be scheduled for removal upon deletion).
        • Forget button: Forget this friend. Just like Clear button above, but specific to a single friend.
        • Use global note check-box: Enable, disable or delegate the use of pool's note for this friend for current alt.
        • Note: Pool's note for this friend. When the use of global note is enabled, you can edit this description.
        • Known by list: Non-editable list of which alt have this friend in its friend list.
  • Options tab: Each check-box groups in this tab is composed of 2 checkboxes. One (Character override) controls the option for the current alt you're connected with, and the other (Global setting) controls the default value for all your alts.
    • Auto-import check-box group: Controls automated import, which happens when your alts enters the game: friends scheduled for addition will be added to your friend list, friends scheduled for removal will be removed from your friend list, and friend notes whose update is allowed will be updated in your friend list.
    • Auto-export check-box group: Controls automated export: friends you know when entering the game will be added to synchronization pool. Also, friends you add or remove and notes you change (if allowed) will update friend status in the synchronization pool.
    • Sync notes check-box group: Controls automated note import separately from friend import. This allows you to synchronize your friend lists without risking overwriting notes you set.
    • Auto-forget check-box group: Controls if, when a friend in synchronization pool is not known by any of you alts, he should be removed from the synchronization pool. This removal happens when your last alt knowing this friend removes him from his list.
    • Auto-remove guildmates check-box group: Controls if, when in the same guild as a friend, that friend should be remove from your friend list. When this becomes false (either you or him leave the guild), he will be added back.

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

  • Avatar of Subdino Subdino Oct 23, 2010 at 20:06 UTC - 0 likes

    Follow-up for normi08 post: He notified me that clearing up his Cache directory made the problem go away.

  • Avatar of normi08 normi08 Oct 18, 2010 at 14:19 UTC - 0 likes

    Unfortuneatly the Addon causes an LUA Error Loop for me! After adding a friend to one char than logging in another char and opening the friend list i get a lua error with a continously increasing error counter.



Date created
Oct 24, 2009
Last update
Jun 28, 2015
Development stage
  • deDE
  • enUS
  • frFR
  • zhTW
GNU General Public License version 3 (GPLv3)
Curse link
Recent files
  • R: 1.3.3 for 6.2.0 Jun 28, 2015
  • R: 1.3.2 for 6.0.2 Oct 25, 2014
  • R: 1.3.1 for 5.4.0 Sep 27, 2013
  • R: 1.3 for 4.2.0 Jun 29, 2011
  • R: 1.2.2 for 4.1.0 Jun 29, 2011



Tool used
Required dependency