Changelog

All notable changes to BetterFriendlist will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

---

[3.1.1] - 2026-11-10

All WoW Versions

Fixed

• New Settings Hint - The hint appears next to the friends list when you open it.

---

[3.1.0] - 2026-11-10

All WoW Versions

Added

• New Settings - Open Settings from the friends list or type /bfl settings to browse by category or search for an option. Search puts matching pages and results you often choose near the top. Hover over a setting to see what it does, or click its row to keep it highlighted and pin the help and any comparison. The main preview shows your saved setup.
• Friend Tags - Use Icon Color to tint any tag icon, including Blizzard icons and custom paths. In Icon Only mode, you can show the tinted icon on its own.
• Tag Sections - Choose a section for each tag, including Blizzard tags, or create your own. Drag sections and the tags inside them to set their order in the editor and friend menu. You can hide sections or delete them with or without their tags.
• Dynamic Tag Groups - Show each friend in their highest matching tag group. Choose a standard header, a colored title, or Tag Chip to tint the header and show the tag icon beside the title.
• Blizzard Tags - Remove built-in tags from BetterFriendlist and bring them back with Restore Tags. Their assignments are kept.

Improved

• Global Friend Sync - Global Sync is available on flavors that still use WoW's old friends list. Its settings and invite shortcuts are hidden on flavors that use Title Friends.

Fixed

• Nickname Dialog - Canceling the new group window no longer leaves red text or a group-name error in the nickname box.
• World Map Tooltips - Quest tooltips from the world map no longer pop up through the friends list.
• Friend Requests - Fixed missing pop-ups for Battle.net and Title Friend requests. The pop-ups still follow your WoW notification settings.
• Raid Tab - Raid members listed as Unknown now show their name as soon as WoW has it. You can right-click them once the name appears.
• Window Scale - The friends list keeps its scale when you switch between fullscreen and windowed mode. Settings and Friend Tags follow the friends list scale and fit on smaller screens.
• Friend Tags - Creating a tag keeps the editor where you placed it. Confirm or cancel the color picker before applying changes to a tag. Custom tags in the friend menu follow the order you set in the editor.
• Settings - The active category stays highlighted when you adjust Control Opacity.

Retail Midnight & WoW Forever

Improved

• Friend Search - Find Title Friends even when they're offline, or search by Battle.net account name, including Real ID names.
• Copy BattleTag - In the Modern friends list, the icon next to your BattleTag now copies it straight to your clipboard when WoW supports it.

Fixed

• Who Search Builder - The Who results scrollbar no longer overlaps the search builder's close button in the Modern layout.
• Title Friends - Character names appear once in the friends list and Friends Broker, with class colors and icons.

Retail Midnight

Fixed

• Friend Invites - The invite button now works for Battle.net friends with one character you can invite, even when WoW leaves out some character details.
• Recent Allies - The tab shows the last known list right away and updates it in the background.

WoW Forever

Fixed

• Who Searches - Shift-left-clicking a character name in chat runs the lookup without opening BetterFriendlist's Who tab by default. You can turn automatic opening on under Who settings.
• Title Friends - Title Friends keep their groups and friend notes when they go offline, switch characters, or you log back in.

---

[3.0.3] - 2026-11-09

All WoW Versions

Fixed

• Friend Menus - Fixed cases where right-clicking a friend failed to open their menu.
• Whispers - Click to Whisper and the Whisper menu option now open the chat box in cases where they previously failed.
• Who Searches - Who no longer skips searches that previously left the results list unchanged.

---

[3.0.2] - 2026-11-07

BetterFriendlist 3.0.2 brings back Blizzard's friend menu, fixes chat taint when you start a whisper, and makes friend tags easier to edit.

All WoW Versions

Added

• Hints - BFL can now show a hint when a nickname, friend tag, private note, new group, or favorite is hidden. You can open the options from the hint.

Improved

• Friend Menus - Blizzard's friend menu is back in both layouts when you right-click a friend in the list or Friends Broker. BFL's group, nickname, and tag options are there too, along with actions from compatible addons.
• Raid Tab - Right-click a raid member to open Blizzard's raid menu.
• Friend Tag Editor - Preview changes for each tag and use Save All to save your drafts when closing the editor. Reset previews the default look, and the delete prompt shows how many friends have the tag.
• Tag Appearance - Open the icon picker in one click, enter a custom path, or remove the icon. Icon Only keeps your custom text for later, and hiding a tag keeps your choices for where it appears.

Fixed

• Chat Taint - Whisper from a right-click menu, single- and double-click whispers, and the Legacy Send Message button now use Blizzard's own whisper action to fix chat taint. Who, Recent Allies, the guild tab, and both brokers use it too, so the separate Taint-Free Whisper window and setting are gone.
• Friend Tag Editor - Fixed a bug that could reset a custom tag's name, icon, text, or colors when you switched tags or made a new one.
• Settings - Guild filters, sorting, and row options now take effect right away in both settings windows. The same goes for Streamer Mode and broker display options.

Retail Midnight

Improved

• Forever Friends - See a Forever friend's realm ruleset in the friends list and tooltips, or add it to a custom format with %ruleset%. The display updates when they switch between Forever and Retail.

Fixed

• Blizzard Friend Tags - Removing a friend's last Blizzard tag updates the list right away. You can edit another friend's tags while the first change is still pending.

Retail Midnight & WoW Forever

Improved

• Legacy Settings - When you use the Modern friends list, Legacy Settings uses the same backgrounds, dividers, and scrollbar.

WoW Forever

Improved

• Friend Invites - Invite and Request to Join in Blizzard's friend menu check realm rulesets, even if your friend has more than one character online.

Fixed

• Who Searches - The friends list stays put when another addon runs a Who search in the background.

---

[3.0.1] - 2026-11-06

BetterFriendlist 3.0.1 improves group note sync and backups, adds ruleset checks for invites in WoW Forever, and makes smooth scrolling optional.

All WoW Versions

Added

• Full Backups - Exports now include private contact notes and saved note backups. Both backup windows explain that the exported data can contain private information and friend names.
• Global Sync Database - Use Delete All to clear saved Global Sync entries and their notes for this client after confirmation, without removing anyone from your Blizzard friends list.

Improved

• Group Note Sync - Large syncs send queued updates without waiting for each note to appear or repeatedly sending changes already awaiting confirmation. Progress shows what is queued and what is waiting, with fewer repeated friend-list reads and window refreshes.
• Note Cleanup - The wizard keeps its recovery copy across retries, waits for delayed note changes, and lets you stop cleanup while keeping the backup. Title friend backups can be restored during the same game session.
• Backup Text Fields - Large pastes in the import and export windows are buffered to reduce pauses. Selections and text after the insertion point are preserved.

Fixed

• Group Assignments - Existing note tags are read before syncing starts, and assignments stay intact when groups are renamed or changed during a sync. Group names containing # are supported, though other FriendGroups addons may display their escaped form.
• Settings Imports - Backups are checked before replacing your data, and the previous settings are restored if applying an import fails. Nested filters and older group colors are preserved.
• Global Sync Backups - Saved friends and Global Sync options are restored only into the same WoW client type, keeping Retail, Forever, and Classic separate. Imports from another client or older backups without this information keep your existing Global Sync data.
• Game Icons - Friends playing WoW Forever show Blizzard's matching game icon in the friends list, tooltips, account menus, and the Data Broker.
• Friend Tags - Removed patch-number references from the Blizzard handoff heading and description.

Retail Midnight & WoW Forever

Improved

• Scrolling - Immediate scrolling is the default again, matching the behavior before 3.0.0. Enable Smooth Scrolling in General settings to animate scrolling in either the Modern or Legacy layout.

WoW Forever

Added

• Ruleset Display - Friend details show Normal, PvP, RP, or RP-PvP instead of internal realm names. The default info line includes the ruleset, and custom name and info formats can use %ruleset%.
• Ruleset Invites - Invite and Request to Join now check rulesets as well as faction. The party button is disabled for a different ruleset and explains why on hover; friends with several online characters can still use a compatible character.

Fixed

• Class Colors - Retail friends keep their Monk, Death Knight, Demon Hunter, and Evoker colors when viewed in Forever, including in tooltips, account menus, and the Data Broker.
• Character Names - Auto Raid Assist keeps complete first and last names when finding, saving, and promoting Title friends. Raid, guild, and Quick Join displays also preserve surnames.
• Who Searches - Who searches open in BetterFriendlist instead of Blizzard's Who or Looking For Group window, including searches from /who and character links. Looking For Group remains available for its normal group activities.
• Global Sync - Saved entries can be removed from the sync database without removing Blizzard friends. The invite list opens horizontally centered over the friends list.

WoW Classic

Fixed

• Backups and Notes - Fixed missing characters at the end of some backup strings. Non-English group names can use the full note length supported by the client.

---

[3.0.0] - 2026-11-03

BetterFriendlist 3.0.0 adds saved Who searches, an option to show friends' alts in tooltips, and smoother scrolling on Retail and Forever.

All WoW Versions

Added

• Known Characters - You can now link alts to a friend and show them in their tooltip. You can add characters yourself or let BFL remember characters it sees your Battle.net friends play. Both options are off by default, and the list stays hidden in Streamer Mode.
• Who Searches - Use the star next to the search box to save up to 12 searches or pick a recent one. You can edit it before hitting Search, and you can clear or turn off your search history.
• Friend Tooltips - Tooltips now show whether someone is a WoW, BattleTag, or Real ID friend when that info is available.

Improved

• Themes - Dark and Custom now draw many of their flat borders the same way, including in Settings and the Friend Tag Editor. Each theme keeps its own colors.
• Changelog - Drag the bottom-right corner to make the window wider or taller. It remembers your size the next time you open it.
• Settings Center - Clicking a search result highlights the setting it takes you to. Pages with tabs no longer repeat the tab name above the settings, and the Note Cleanup descriptions have room to wrap without covering the buttons.

Fixed

• Recently Added - Long-time friends no longer show up as newly added while your friends list is still loading or after a reconnect.
• Faction Icons - Faction icons now show up with name-only and BattleTag-only layouts when enabled.
• Settings and Setup - Support links copy in full, window size fields have room for the whole number, and filters stay inside the list while you drag them. Checkbox borders in Dark and Custom and the borders on the setup summary are more even.
• Group Actions - Fixed errors when promoting someone or changing the group type in combat, and when blocking Battle.net friends while Blizzard restricts the action.
• Who and Friend Tooltips - Saved searches keep their wording when you open them in the Search Builder. Friend details no longer stick around when the game reuses a tooltip.

Retail Midnight & WoW Forever

Added

• Smooth Scrolling - The friends list now scrolls smoothly by default in both the Modern and Legacy layouts.
• Recent Allies - Click a player to see what you did together and how long ago. You can also see their latest activities in the tooltip.

Improved

• Changelog - The changelog window now uses backgrounds from the Modern friends list when that layout is active.

Fixed

• Recent Allies - Fixed errors when details about another player are hidden, including in the pin tooltip. Preview entries can no longer trigger real player actions.
• Modern Friends Window - Side tab icons and the Who scrollbar stay lined up when you switch tabs. In Dark and Custom, disabled buttons are easier to spot, and the Streamer Mode header and Raid help text are less bright. The Guild filter only shows its selection once.
• Streamer Mode - If a Title friend has no BattleTag, the friends list and right-click menu show their character name.
• Who Search - Class and race filters work again on clients where those searches could fail.
• Raid Tab - The Raid tab follows the game's availability rules, and promotion buttons respect who can promote group members.
• Guild Roster - You can still open the guild list when the game temporarily hides extra details like professions.

WoW Forever

Fixed

• Quick Join - Quick Join unlocks with Group Finder at level 10. If it isn't available yet, the setting shows why.
• Global Friend Sync - Saved names keep their surnames, and BFL skips your own character. If you have saved friends left to invite, use the globe next to Add New Friend. Add All opens Blizzard's confirmations one at a time.

WoW 12.1.7 PTR

Compatibility

• PTR Support - Updated BetterFriendlist and the Menu Bridge for the 12.1.7 PTR.

---

[2.9.2] - 2026-10-11

BetterFriendlist 2.9.2 adds a WoW Forever filter and fixes greyed-out group invites, along with a few smaller fixes.

All WoW Versions

Fixed

• Group Invites - Fixed cases where Invite was greyed out in a Battle.net friend's right-click menu, including friends on other realms in WoW Forever. The character picker also handles friends with multiple WoW accounts.
• Remove Friend - The confirmation now uses the correct wording for WoW, BattleTag, and Real ID friends.
• Changelog - The current version's draft notes now appear in both in-game changelog views.
• Invite Tooltip - Offline friends now show a red offline message. Fixed incorrect faction warnings and added available group activity details when requesting to join.
• Context Menu - Empty Interact headings are no longer shown when no actions are available, including offline Title friends.
• Friend List - Fixed missing updates when reopening the friends list after changes while it was closed.
• Who Class Filters - Fixed missing class options on some clients, including Druids on Classic.
• Settings and Skins - Fixed errors that could occur when Settings, Who, or an addon skin accessed UI details restricted by Blizzard.

Retail Midnight & WoW Forever

Fixed

• Battle.net Blocking - Block actions are now hidden for Title friends or when the required account details are missing. Friend requests are checked again before an account is blocked.
• Title Friend Colors - Online Title friends also use class colors in name-only layouts when enabled. Offline names stay gray.

WoW Forever

Added

• WoW Forever Filter - A new quick filter shows friends playing WoW Forever in the friends list and Data Broker.

Fixed

• Character Names - Friends' character menus, Copy Character Name, and Quick Join no longer add unnecessary realm names. Forever surnames are kept in player links.
• Add Friend - BFL now opens Blizzard's Add Friend window in Forever, including its handling of Title friend requests.
• Title Friend Names - Title friends show the character name once in the default layout and friend tooltip. Custom names are still shown in the list if they differ from the character name.
• Friend List - Fixed an empty friend list after login or reloading when a title friend appeared first.

---

[2.9.1] - 2026-09-27

BetterFriendlist 2.9.1 adds new Guild tools, updates the Settings Center, and fixes several Who and Group Finder problems.

All WoW Versions

Added

• Raid PvP Icons - Raid and party rows can now show PvP faction or prestige icons when available.

Improved

• Private Notes - Private Notes are no longer a Beta feature. They remain disabled until you turn them on.
• Settings Center - Updated the Settings Center library. It now uses direct links to features, two-column pages, and grouped option rows.
• Themes - Dark and Custom themes now update faster when you change their colors.
• Auto Raid Assist - Search results now show Battle.net friends first, followed by WoW and Title friends, and then guild members. Battle.net results and targets use Battle.net blue, while WoW, Title, and Guild entries use class colors.
• External AddOn Menu Bridge - The bridge is no longer a Beta feature and is switched on once when upgrading to v2.9.1. You can turn it off again at any time. If the companion addon is disabled, the option is greyed out and explains why.

Fixed

• Blocked Actions - Fixed errors caused when BFL or an addon skin tried to recolor a UI element locked by Blizzard.
• Search and Sorting - Search and sorting now skip names or text hidden by Blizzard.

Retail Midnight & WoW Forever

Added

• Guild Roster - Profession filters now sit inside the main Guild filter and work together with Online, All, and Offline. Message of the Day, Guild News, and Guild Information share one larger area. Guild News is always available when supported and includes filters, a scrollable history, and links for achievements and items.
• Guild Member Menu - Right-click a guild member to add them as a friend, ignore them, or view their house when available. The unused Who option has been removed.
• Quick Join - Tooltips can now show the group leader's level.

WoW Forever

Added

• BattleTag Friend Requests - Title friends can now be added as Battle.net friends from their right-click menu.

Improved

• Character Names - Forever surnames are now kept in Who searches, right-click menus, and Recent Allies notes.
• Context Menus - Block and remove actions are now shown in red.

Fixed

• Group Finder - Fixed blocked-action errors that could appear after using BFL's Who tab.
• Who During Combat - Typing or pressing Escape in the Who tab during combat no longer causes blocked-action errors.
• Blocking - Battle.net blocking works again, and Title friends no longer show an unusable Block Invites option.
• Restricted Chat - Whisper actions are disabled and show Blizzard's reason when the account is not allowed to chat.

---

[2.9.0] - 2026-09-18

BetterFriendlist 2.9.0 adds support for WoW Forever to BetterFriendlist and the Menu Bridge without changing the existing Retail Midnight and Classic experiences.

All WoW Versions

Improved

• Changelog Notice - The BFL avatar now uses the same pulsing glow animation as the Friend Requests tab when a new changelog is available.
• Who Search Builder - Opening the Search Builder now imports the current Who query, including name, guild, zone, class, race, and level filters. Additional free-form search terms are preserved.
• Who Search Feedback - Who searches now show the same loading spinner used by Recent Allies while waiting for the server. “No players found” appears only after a completed empty response, while a timeout keeps its separate retry message.

WoW Forever

Added

• WoW Forever Support - BetterFriendlist and the Menu Bridge now recognize Forever as a modern Mainline client despite its 1.60.1 version. Available social views and features—including Forever's Recent Allies categories—follow the APIs and live game rules provided by the client, while unsupported Midnight-only features remain hidden. Retail Midnight and every supported Classic flavor retain their existing behavior.

Fixed

• Forever Who Routing - /who now opens BetterFriendlist directly on its Who tab and performs the search there without also opening Forever's separate LFG Who window. The native Group Finder remains available through its own UI.
• Forever Keybindings - The Social shortcut is now migrated only after Forever has loaded a writable binding profile, preventing a Lua error during login.

Retail Midnight

Fixed

• Raid Member Right-Click - Hovering raid members no longer causes a protected-frame anchor error. The normal Blizzard menu, including protected actions, still opens through the secure proxy in both Retail layouts.

---

[2.8.8] - 2026-09-13

Retail Live & Classic

Added

• Master Looter - Classic raid and party lists now show who is Master Looter. The icon also works with both Retail raid layouts if the client provides that flag.

Improved

• Addon Window Spacing - EnhanceQoL, GlobalIgnoreList, and NorthernSkyRaidTools now leave room for the Modern side tabs. Their Legacy positions stay as they were.

Fixed

• Story Mode Raid Tab - The Raid tab is now disabled during a Story raid and shows Blizzard's reason when hovered.
• ElvUI Broker Tooltips - Friends and Guild Broker tooltips use the selected ElvUI tooltip style again.
• Broker Tooltip Scrolling - Friend updates no longer jump a scrolled Friends Broker tooltip back to the top.
• Raid Member Right-Click - The Raid Player menu works again in both Retail layouts. Regular clicks, shortcuts, selection, and drag-and-drop keep working on the same row.
• Raid Counts - Member and role counts update after returning to a Raid tab that changed while it was hidden.

WoW 12.1.5 PTR

Added

• Friend Search and Sorting - On 12.1.5, BFL can use Blizzard's new locale-aware text APIs for local friends, tags, groups, realms, and Recent Allies. Other clients keep the existing search behavior.

Compatibility

• New Client APIs - Added checks for the new internationalization, LFG, and timer APIs so they are only used when the client provides them.
• Raid Updates - Repeated raid and LFG events now share one pending refresh on 12.1.5. Older clients keep the existing timer path.
• Matchmade Raid Markers - Main Tank and Main Assist markers are hidden when 12.1.5 reports a matchmade raid without manual role requirements.

---

---

Older versions archived. Full history available in git.