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.

[2.6.2-beta3] - 2026-06-01

Improved

• Broker Tooltip Theming - Added settings for the shared Friends/Guild Broker separator color and per-theme Broker tooltip background color and opacity. Find the separator color under Settings > Data Broker > Broker Tooltip Appearance, and the background/opacity controls under Settings > Theme > Broker Tooltips.
• Party Invites - Improved the invite buttons in the WHO list and Recent Allies so they keep working reliably on Retail and Classic, including upcoming Retail updates.

Fixed

• Quick Join - Restored the card-style group display with activity images.
• Broker Separators - Made Friends and Guild Broker header, group, empty-state, and footer separator lines use the same configured color and pixel-consistent thickness.
• Guild Broker Groups - Made expand and collapse indicators match Friends Broker formatting and use the same color as their group headers.

[2.6.1] - 2026-05-31

Added

• Guild Tab Beta - Added a default-off Retail-only beta Guild tab with BetterFriendlist-owned roster search, online/offline filtering, sorting, guild counts, member details, notes, class and status indicators, and safe member actions where permissions and Blizzard APIs allow them. Enable Beta Features under Settings > Advanced > Beta Features, then turn on the Guild roster tab under Settings > Guild. Classic support for this beta feature will follow in a later version.
• External AddOn Menu Bridge Beta - Added a default-off beta bridge and official companion AddOn for showing compatible AddOn actions in supported BetterFriendlist context menus. Enable it under Settings > Advanced > Beta Features.
• Theme Customization - Added Retail-only beta theme customization with a Custom theme based on Dark, expanded Dark and Custom settings for colors, opacity, hover and selection states, borders, scrollbars, icons, and BFL Avatar visibility. Enable Beta Features under Settings > Advanced > Beta Features, then configure themes under Settings > Theme. Classic support for these beta theme features will follow in a later version.
• Raid Tab - Added an optional compact Ready Check button next to Raid Info. Enable it under Settings > Raid.

Improved

• Guild Broker Tooltips - Added a subtle separator between Friends Broker groups and Guild Broker rank groups.

Changed

• Client Compatibility - Prepared friend invites and raid controls for upcoming Retail client changes while preserving current Retail and Classic support.
• Raid Tools - Improved handling for temporarily uncached raid roster names.
• Font Rendering - Made custom font handling more defensive on newer clients.

Fixed

• Friend Menus - Restored Blizzard's invite versus request-to-join labels and actions for Battle.net friends.
• Recruit A Friend - Shortened the search placeholder and kept it on one line in the header search field.
• Tabs - Fixed truncated top and bottom tab labels showing duplicate hover tooltips.

Performance

• Top Tabs - Reduced hitches when switching between Friends, Recent Allies, Recruit A Friend, and Guild tabs.
• Guild Roster - Reduced memory churn when reopening or switching to the Guild roster tab.
• Quick Join - Reduced repeated row-height work while showing available groups.

[2.6.0] - 2026-05-25

Added

• QuickFilter & Sorter Builder - Added a dedicated settings tab for choosing visible QuickFilters and Sorters, building custom filter rules and sorter chains, previewing changes, and choosing BFL or Blizzard icons. Enable Beta Features under Advanced > Beta Features to show the tab.
• Theme Settings and Dark Theme - Added a dedicated Retail Theme tab with Blizzard, Dark, and ElvUI choices, plus a BFL-owned Dark theme for BetterFriendlist windows, rows, dialogs, settings, and broker tooltips. Enable Beta Features under Advanced > Beta Features to show the tab. Classic support will follow as soon as possible in one of the next releases.
• Font Rendering - Added per-font rendering flag settings and Slug rendering support on compatible clients.
• WoW Online Filter - Added a quick filter for showing only online friends who are currently in WoW.

Changed

• QuickFilter and Sorter Menus - QuickFilter menus, sort dropdowns, and Broker cycling now respect custom visibility and order, with safe fallbacks for hidden active selections.
• Theme Safety - Theme choices now fall back safely when Beta Features are disabled, on non-Retail clients, or when ElvUI is unavailable.

Fixed

• Friend Tooltips - Restored the "Also in group" details and Blizzard-matching restrictions on Battle.net request-to-join buttons.
• ElvUI Skin - Fixed startup, availability, and settings-toggle issues when ElvUI was selected, unavailable, or managed outside the Retail beta Theme tab.
• Menu Compatibility - Fixed protected Retail unit menu handling and restored Total RP 3 profile actions in BetterFriendlist friend menus.
• Raid Tools - Fixed a Lua error after moving players between raid groups with drag and drop.
• Recruit A Friend - Fixed reward-viewing tab issues, protected Copy Link errors, and a tooltip stack overflow.

Performance

• Friend List Sorting - Reduced CPU time and memory churn when changing QuickFilters and Sorter selections.
• Quick Join - Reduced repeated group-priority and friend-relationship lookups while sorting available groups.

Outlook

• Guild Tab - A Retail and Classic Guild tab is planned for upcoming releases, with a BetterFriendlist-owned roster view for searching guild members, filtering online/offline members, sorting by rank, name, level, class, zone, status, and last online time, and showing guild counts, notes, status, and class information through the shared safe roster provider.

[2.5.9] - 2026-05-17

Fixed

• ElvUI Top Tabs - Centered the Friends, Recent Allies, and Recruit A Friend tab labels in the ElvUI skin.

[2.5.8] - 2026-05-16

Added

• Broker Tooltip Fonts - Added an optional setting for using selected broker tooltip fonts on non-latin alphabets, with a warning about unsupported glyphs.
• Guild Broker MOTD - Added the guild message of the day to the Guild Broker tooltip with guarded cross-version handling.

Fixed

• Guild Broker Click Action - Fixed the configured left-click action not opening the guild frame or broker settings.
• Recruit A Friend Taint - Reduced RAF list taint by keeping addon display data separate from Blizzard recruit records.

[2.5.7] - 2026-05-16

Fixed

• Classic Loading - Fixed a load error after the latest update.

Changed

• Client Compatibility - Added TOC support for newer Retail and Classic client builds.

[2.5.6] - 2026-05-15

Added

• Advanced: Taint-Free Whisper - Added an optional inline whisper bar under Advanced that lets you message friends without opening Blizzard chat.
• Friend List Whisper Click - Added an optional Behavior setting to start whispers from friend rows with a double left-click or single left-click.
• Broker Tooltip Fonts - Added global font and font size settings for Friends and Guild broker tooltips.
• Friends Broker: Filter-Aware Display - Broker text and tooltip counts now follow the active quick filter, including Online, All, WoW only, and In A Game.
• Friends Broker: Columns - Added optional Nickname and Status columns, class icons in the Character column, and configurable group name alignment.
• Broker Hover Details - Friend and guild broker rows now show overlay detail tooltips on hover.
• Friends Broker: Styling - Added per-column colors, main-list name color syncing, ElvUI tooltip styling, Blizzard client icons, rich presence/mobile/app labels, and a toggle for footer hints.
• Guild Broker Plugin - Added an optional Data Broker plugin for guild rosters with online/all filtering, collapsible rank/class groups, configurable columns, member actions, rank management, and all-version support. Enable it in Settings > Broker > Guild Plugin.
• Guild Broker: Roster Options - Added nickname, professions, class icon, applicant count, hide-max-level, and exclude-yourself options, with drag-and-drop column ordering.
• Guild Broker: Sorting and Status - Added sort modes for name, rank, level, class, zone, and nickname plus AFK/DND status indicators.
• Guild Broker: Colors - Added custom nickname colors and configurable Rank, Zone, Note, and Officer Note colors.
• Guild Broker: Compatibility - Added support for Retail secret-value clients, migration-friendly saved column layouts, clean member tooltip cleanup, and streamlined profession rank display.

Improved

• Broker Refreshing - Data Broker plugins now refresh reliably after Battle.net and friend roster updates, including when Beta Features are disabled.
• Broker Display Compatibility - Improved tooltip cleanup for broker display addons such as Arcana and Bazooka.
• Secret-Value Context Menus - Modern clients now use BetterFriendlist-owned friend menus for Friend, Battle.net Friend, and Recent Ally actions instead of patching protected Blizzard menus.
• Friend Tooltips - Battle.net friend hover tooltips now use sanitized data on secret-value clients and class colors when class-colored names are enabled.
• Social Keybind - The Social key now opens BetterFriendlist directly and migrates or restores cleanly without reload prompts or Guild/Communities taint.
• Quick Join - Group Finder listings opened from Quick Join now use Blizzard's native sign-up dialog.
• Combat Window Toggle - Opening and closing BetterFriendlist during combat is more reliable when Respect UI Hierarchy is enabled.

Fixed

• Blizzard Friends Frame Replacement - Blizzard and addon calls that open the default Friends frame now route to BetterFriendlist more consistently, preventing both windows from opening or closing out of sync.
• Escape Key Handling - Pressing Escape now closes BetterFriendlist more reliably, including when the frame is opened outside the normal UI panel path.
• Taint-Free Whisper Focus - Closing the inline whisper bar with Escape no longer blocks normal keybinds while BetterFriendlist stays open.
• Broker Hover Details - Friend and guild broker detail tooltips now stay above the main broker tooltip and no longer trigger QTip release errors while closing.
• Tab Navigation - Fixed the window getting stuck on the Who or Quick Join tab after using /who or clicking a group join link.
• Broker Counts - Fixed stale, zero, total-friend, and filtered-count display problems across Friends broker quick filters.
• Broker Group Headers - Collapse and expand markers now render as + and - without extra parentheses.
• Retail Chat Taint - Reduced chat history taint by using secret-safe friend menu extension handling on modern clients.
• Guild and Communities Taint - On secret-value clients, BetterFriendlist now avoids Guild/Communities roster hooks and native guild menu extensions while Blizzard's Guild panel opens.
• Recruit A Friend Taint - Reduced RAF list taint noise on secret-value clients by keeping raw Battle.net account payloads out of RAF list rows.
• Quick Join Messages - Whisper links and Send Message actions from Quick Join now open the correct Battle.net conversation more reliably.

[2.5.5] - 2026-04-05

Fixed

• Retail: Quick Join - Fixed a Lua error caused by protected values during combat restrictions.

[2.5.4] - 2026-04-03

Fixed

• Classic: Sort Dropdown - Fixed an error when selecting a sort option (e.g., "Game") in Classic clients.

Improved

• Quick Join: Known Players - Quick Join entries now also show guild members and community members next to the group leader, not just friends. Community members additionally display the community name they belong to.

Older versions archived. Full history available in git.