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.3] - 2026-11-15

All WoW Versions

Fixed

• Settings Menu - The Settings entry in the contacts menu keeps its normal size when marked New.

---

[3.1.2] - 2026-11-14

All WoW Versions

Added

• Favorite Icon - Choose the Modern Blizzard favorite star where available, alongside the existing BFL and Blizzard styles.
• Settings Window - Everyone now uses the redesigned Settings. Resize the window and keep your preferred size; narrow windows use a separate preview and help window that docks on the free side and remembers its width, height and collapsed state. Open or close it from the Settings edge, use setting tooltips while it is closed, or widen Settings to bring the panel back inside.
• New Settings - New options and their categories carry the same New badge as unread changelog entries. Click an individual setting to mark it read; category badges clear when all their new options have been read. Read status is saved per profile.
• Settings Scrolling - Enable smooth mouse-wheel scrolling in Settings independently of the friends list. Disabled by default.
• Window Fonts - Set fonts and sizes for window titles and main action buttons separately, with previews and a reset to their original fonts.
• Input Dialogs - Create groups, tags, and sections, rename groups, or copy links and names in windows that match your BFL theme. You can choose native input dialogs under Theme.
• BFL Avatar - Dark, Custom, ElvUI and EllesmereUI hide the avatar by default. Turn off Hide BFL Avatar under Theme to show it again.

Improved

• Side Windows - Dialogs and hints use the free space beside the friends list and switch sides when needed. In the Modern layout, they prefer the selected tab side.
• Scrollbars - Modern scrollbars retain their Blizzard appearance and use the accent color of Dark, Custom, ElvUI or EllesmereUI themes. Disabled scroll arrows stay gray.
• Friend Tag Editor - A redesigned editor matches Settings, with tag search, clearer sections, drag-and-drop feedback and direct list actions. Edit icons or custom paths, text, colors and visibility with live previews and pinnable help; per-tag drafts are kept until you apply or discard them, including when switching tags or resizing.
• Name Formatting - Browse format fields in a list under Setting details, collapsed by default. Click a field to select its token for copying.
• QuickFilters & Sorters - Manage filters and sorters in a simpler list, with descriptions for built-in filters and clearer game and status icons. Matching Blizzard icons are used where available; the remaining icons will be updated in a future release.
• Groups - Create a group from a group header, Group Management, or Group Order.

Fixed

• Display Changes - Button text and group counters refresh after switching display modes or changing UI scale.
• Themes - Raid Roster Help and the Assist All checkbox use the selected theme throughout, and button hover effects no longer reveal their original artwork. Footer backgrounds no longer extend into the friends list or leave an extra panel beside Add New Friend.
• Known Characters - The tooltip no longer repeats the character already shown above. Other known characters remain available, including when a friend is offline.
• Tag Sections - Hiding or showing a section updates its tags and dynamic tag groups immediately. Each tag keeps its previous visibility choices.
• Settings Performance - Reduced pauses when changing pages, toggling QuickFilters or changing Simple Mode with the Dark or Custom theme.
• Theme Settings - Selecting Dark or Custom immediately shows its customization controls. Broker tooltip appearance options are shown only for themes that support them.
• Settings Controls - Disabled controls, including EllesmereUI dropdowns, look inactive throughout Settings; their rows still offer hover explanations.
• Recently Added Group - Duration Value accepts only numbers.
• Settings Preview - Empty-group notices identify the groups actually hidden in the preview.
• Dynamic Tag Groups - Friends in a tag group leave No Group, including when it has been renamed. Group invitation counts and actions use the members shown in that group.
• Group Names - Create and Rename accept letters after a popup slot was used for numeric input.
• Friend Invites - Right-click menus preserve Blizzard's invitation action and offer a character picker when multiple accounts are available.
• Window Position and Scaling - The friends list restores its saved position after switching display modes or reopening near a screen corner. Settings stays within the available screen space when the friends list scale changes.
• Raid Tab - Party members whose names WoW temporarily hides show as Unknown. Raid members appear as soon as WoW provides their name, even if the raid roster is still loading.

WoW Retail & WoW Forever

Added

• Friend Tabs - Place Modern tabs on the left or right of the friends list, with the right side as the default. The window keeps the selected tab rail on screen when you change sides.

Improved

• Quick Join - Group tooltips show when a listing welcomes new players.

Fixed

• Search Field - With ElvUI loaded and the Blizzard theme selected, the native search field no longer draws an extra background over BFL's search box.

WoW Forever

Improved

• Quick Join - Group tooltips show when a listing uses Discord voice chat.

Fixed

• Title Friends - Whisper is available for Title Friends who appear offline. WoW looks up the character to whisper.

---

[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.

---

---

Older versions archived. Full history available in git.