Skip to content

User Guide

Jump to bottom
Joe edited this page Aug 5, 2026 · 2 revisions

This guide covers every part of Epithet from a player's perspective. For the underlying code, see Developer & Technical Documentation.

Contents

The Title Browser

The Epithet Title Browser is the main interface of the addon, opened with /epithet or /titles. It displays a comprehensive list of all titles available in the game. Each title is shown with its name, source, and a colour-coded rarity tier that uses standard WoW item-quality colours (e.g. Gray for Common, Orange for Legendary). Select a title to see its detail panel: how it's obtained, its category and expansion, and (if you've earned it) the date you got it.

Filtering and Sorting

You can refine the list of titles using the sidebar filters:

  • Search: free-text search to find specific titles by name or source.
  • Status: show all titles, only earned titles, or only unearned titles.
  • Rarity: filter by rarity tier (Common to Legendary).
  • Type: prefix or suffix titles.
  • Category: filter by how the title is earned (Quest, PvP, Reputation, Raid, Achievement, Profession, Holiday, Exploration, Campaign, etc.).
  • Expansion: filter titles by the expansion they were introduced in.
  • Faction: Alliance-only, Horde-only, or both.
  • Additional filters: hide unobtainable titles, hide time-sensitive (seasonal/limited) titles, or show favourites only.
  • Obtainable Only toggle: shows your earned percentage against the obtainable pool only, hiding permanently unobtainable or time-sensitive titles from that count.

Sort the list by Collected First, Expansion, Alphabetical, Quality, or Category. Star any earned title to mark it a favourite — favourites pin to the top of the Collected group when sorting by "Collected First".

Setting Titles

Due to WoW API limitations, the SetCurrentTitle API function is protected and must originate from a hardware event. To set an active title, select it in the browser and click the Set as My Title button — this registers the physical click needed to apply the title to your character.

Understanding Rarity

Since World of Warcraft does not provide an authoritative rarity feed for titles, Epithet uses a 5-tier heuristic derived from the acquisition category and, where available, real-world holder statistics:

Tier Label Criteria
5 Legendary Seasonal PvP Gladiator/R1/Hero, Grand Marshal/High Warlord, Scarab Lord
4 Epic Removed/unobtainable, Challenge Mode Gold, Hall of Fame, Cutting Edge, "the Insane"
3 Rare Multi-patch meta-achievements (Loremaster, Glory metas), M+ score titles
2 Uncommon Single achievements, holiday metas, campaign completion, exploration
1 Common Baseline rep grinds, low PvP ranks, trivial quest rewards

An unobtainable title held by very few players gets a rarity floor bump (below 2% of holders → at least Epic, below 5% → at least Rare), and the in-app "i" popup next to the rarity legend explains the calculation in full. Click the info button on the title-bar for details about Epithet itself.

Title Spotting (Social Layer)

Enable Title Spotting in Settings and Epithet overlays the title currently displayed by whoever you're targeting, anchored below your target's nameplate/frame. Hover the overlay and a tooltip reminds you what each click does:

  • Left-click opens that title in Epithet, so you can see how it's earned.
  • Right-click unlocks the overlay so you can drag it to a new position; right-click again to lock it back in place.

Two layouts are available in Settings:

  • Slimline - a compact, single-line readout.
  • Portrait Card - a larger card with an optional animated 3D portrait of your target.

Behaviour options include:

  • Fade after a delay - the overlay fades out a configurable number of seconds after you target someone (it holds steady while you're actually hovering it, and dismisses immediately once you click through to the title).
  • Hide in combat / Hide in group - keep the overlay out of the way when it isn't wanted.
  • Reset position - snaps the overlay back to its default spot if you've dragged it somewhere awkward.

The Spotting Log

Every title you spot on another player is recorded to a persistent, per-character log (opened from the header button next to the main browser). It tracks:

  • Who was wearing it, and where and when you first (and most recently) saw it.
  • How many times you've spotted it in total.
  • Their class and race.

Switch between List and Grid views, and toggle the log's scope between Spotted and Remaining (titles you haven't spotted yet). You can Export your log to share it, or Import someone else's to merge it into your own — handy for guildmates comparing notes. Right-click the Spotting Log's minimap/header icon to shout your stats in /say.

Epithet Achievements

Opened from its own header button (separate from the Spotting Log), Epithet Achievements is a full achievement system built on top of your spotting and collection data, grouped into three categories:

  • Spotting (account-wide) - for people-watchers: spot a wide variety of titles, classes, zones, and rarity tiers in the wild.
  • Collection (per-character) - for what you actually own, from your first title to a fully-decked-out collection.
  • Crossovers (per-character) - achievements that need both your collection and your spotting habit to line up.

Several achievements are secret and stay hidden until you unlock them. A handful of keyword- and length-based achievements (Lord of Lords, Masterclass, Slay, Quite a Mouthful, Terse) match against a title's English catalogue name behind the scenes, so they're earnable on every supported game-client language, not just English.

Earning one triggers a popup notification. In Settings you can choose:

  • Notification mode: popup + sound, popup only (muted), or off.
  • Popup anchor: follow Blizzard's own achievement/loot alert stack (default), or anchor to the top-centre of the screen — useful if another addon moves or hides Blizzard's AlertFrame.

Settings

Epithet's options live under Options → AddOns → Epithet (or the settings-gear button on the title bar). From there you can configure Title Spotting behaviour, achievement notifications, the addon's frame scale/position, the minimap button, and your language.

Language

Epithet can run in a language different from your game client's own language. Open Options → Epithet → Language and pick from the available translations (Automatic follows your client's language by default). Changing it prompts a UI reload. See Locales and Translations if you'd like to help add a new one.

What's New

After an update, Epithet shows a one-time popup summarising what changed. Missed it, or want to re-read it? Run /epithet whatsnew to bring it back at any time.

Slash Commands

Command Effect
/epithet or /titles Opens the title browser.
/epithet scan Forces a title rescan to refresh your collected titles.
/epithet minimap Toggles the minimap launcher button.
/epithet whatsnew Reopens the What's New dialog for the current version.
/epithet debug Dumps raw title API output for the first known titles (troubleshooting).

Home

Guides

Links

Clone this wiki locally