# Options

> Every setting in the options window, page by page, with its default and what it does.

Page: https://polestar.guide/docs/reference/options (Polestar docs > Reference)

Every setting in Polestar's options window (`/polestar options`), page by page, with its default and what it does, read from the addon's own options registry. A page opens directly with `/polestar options <page>`. Filter below by name, key or any word of its description.

## Guide

Opens with `/polestar options guide`

The guide window, the arrow and its routes, and what Polestar does for you.

### Window

#### What it shows

| Setting | Default | What it does |
|---|---|---|
| **Show the window** `ui.shown` | On | Also /polestar, or the key binding. (Switch) |
| **Compact mode** `ui.compact` | Off | Only the header and the current step's goals. (Switch) |
| **Step tips** `ui.showNotes` | On | The author's tip under the goals, one line until clicked. (Switch) |
| **Expand step tips** `ui.notesOpen` | On | Start each step with its tip in full instead of one line. (Switch) |
| **Upcoming steps** `ui.upcoming` | 0 | How many steps the Up next list holds; 0 turns it off. (Slider (0 to 6)) |
| **Expand Up next** `ui.upcomingOpen` | Off | Start with the upcoming steps listed instead of collapsed. (Switch) |

#### Combat

| Setting | Default | What it does |
|---|---|---|
| **In combat** `ui.combat` | Keep visible | What the window does while you fight. Choices: Keep visible, Fade out, Hide. (Choice) |

#### Dungeons

| Setting | Default | What it does |
|---|---|---|
| **In dungeons** `ui.instance` | Keep visible | What the window does in dungeons and raids. /polestar or the key binding opens it there until you leave. Choices: Keep visible, Hide. (Choice) |

#### Position

| Setting | Default | What it does |
|---|---|---|
| **Lock window** `ui.locked` | Off | Prevents moving and resizing. (Switch) |
| **Lock arrow and buttons** `ui.lockHud` | Off | Stops stray drags on the arrow, the action buttons and the flight and instance timers. Shift-drag still moves them. (Switch) |
| **Grow upward** `ui.growUp` | Off | Keep the bottom edge in place, so longer steps extend the window up. (Switch) |
| **Bar at the bottom** `ui.barsBottom` | Off | With Grow upward, put the tabs and the step bar at the bottom edge, next to where the window is pinned. (Switch) |
| **Reset position** | — | Put the guide window back in its corner. (Action) |

### Arrow & routes

#### Arrow

| Setting | Default | What it does |
|---|---|---|
| **Show arrow** `nav.arrow` | On | Points to the current goal. Its look and colours are under Appearance, Arrow. Greyed out while Shortest Path Forever guides: it does this itself. (Switch) |
| **Arrival time** `nav.arrowEta` | On | Estimated time under the distance. Greyed out while Shortest Path Forever guides: it does this itself. (Switch) |
| **Distances** `nav.distanceUnit` | Yards (the game's unit) | How the arrow, map tooltips, rares and the death helper show distances. Choices: Yards (the game's unit), Metres. (Choice) |
| **Arrival sound** `nav.arrivalSound` | On | A soft chime when you reach a waypoint. Greyed out while Shortest Path Forever guides: it does this itself. (Switch) |
| **Reset arrow position** | — | Back to the top of the screen. Drag the arrow to move it. Greyed out while Shortest Path Forever guides: it does this itself. Shown only when it applies (the addon it works with is installed, or a setting it depends on is on). (Action) |

#### Routes

| Setting | Default | What it does |
|---|---|---|
| **Plan travel routes** `nav.travel` | On | Flights, boats and your hearthstone when they are faster. Off: the arrow points straight at the goal. Greyed out while Shortest Path Forever guides: it does this itself. (Switch) |
| **Walk real paths** `nav.navRouting` | On | The arrow follows paths on the ground around cliffs, water and walls, on Polestar's walking maps, with Shortest Path Forever's router by Cillian Berragan. Off: it points straight at each stop. Greyed out while Shortest Path Forever guides: it does this itself. (Switch) |
| **Route lines** `nav.routeLines` | On | The way to the goal on the world map and the minimap: dots where you walk, lines where you fly, sail or ride, the legs after this one fainter. Drawn as Shortest Path Forever by Cillian Berragan draws them. Greyed out while Shortest Path Forever guides: it does this itself. (Switch) |
| **Class teleports** `nav.teleports` | On | Routes may start with a Teleport spell you know (a mage's city teleports, a druid's Moonglade) when it is faster. A city teleport needs a Rune of Teleportation in your bags. Greyed out while Shortest Path Forever guides: it does this itself. (Switch) |
| **Share boat times** `nav.shareTransit` | Off | Riding a boat, zeppelin, tram or lift times it; your guild and group get those times and you get theirs, so the arrow can say when the next one leaves. (Switch) |
| **Shift-click a map to go there** `nav.mapPlan` | On | Shift-click the world map or minimap and the arrow takes you there; Alt-click works over map icons. Click the spot again to clear it. Greyed out while Shortest Path Forever guides: it does this itself. (Switch) |
| **Route style** `nav.routeStyle` | Balanced | Fastest: the shortest walk, over hills and across fields. Balanced: roads that aren't much longer, and round hills. Roads: stays on roads even when they're longer; the safest way, not the quickest. Greyed out while Shortest Path Forever guides: it does this itself. Choices: Fastest, Balanced, Roads. (Choice) |
| **Nearby services in map menus** `nav.nearbyMenu` | On | The world map's and minimap's tracking menus find the nearest trainer, vendor, inn, bank and more (/polestar near). (Switch) |
| **Nearby services button** `nav.nearbyButton` | On | A button in the guide window's header, left of the menu, finds the nearest vendor, repair, inn, flight master or trainer and points the arrow there. (Switch) |
| **Show the journey** `nav.journeySteps` | On | The route's steps in the guide window with a time for each, counting down: walks, lifts, boats and flights. Click the current step to skip it. Greyed out while Shortest Path Forever guides: it does this itself. (Switch) |

#### Other waypoints

| Setting | Default | What it does |
|---|---|---|
| **Blizzard waypoint** `nav.blizzardWaypoint` | Off | Also set the game's own map pin and tracking. Greyed out while Shortest Path Forever guides: it does this itself. (Switch) |
| **Mirror to TomTom** `nav.tomtom` | On | Adds the target as a TomTom waypoint when TomTom is loaded. Greyed out while Shortest Path Forever guides: it does this itself. (Switch) |
| **Use TomTom's arrow** `nav.useTomTomArrow` | Off | Hides Polestar's arrow in favour of TomTom's. Greyed out while Shortest Path Forever guides: it does this itself. (Switch) |

#### Along the route

| Setting | Default | What it does |
|---|---|---|
| **Travel button** `nav.castPrompt` | On | When the route says to hearth or teleport, a button under the arrow casts it. Right-click the arrow to skip a leg. Greyed out while Shortest Path Forever guides: it does this itself. (Switch) |
| **Transport alerts** `nav.alerts` | On | Before your boat, zeppelin or tram comes in: 30 seconds ahead at the dock, 20 before the next stop on board. Never for lifts or in combat. Greyed out while Shortest Path Forever guides: it does this itself. (Switch) |
| **Show a banner** `nav.alertBanner` | On | A small card near the top of the screen with a countdown. Click it to dismiss. Greyed out while Shortest Path Forever guides: it does this itself. (Switch) |
| **Play the transport's sound** `nav.alertSound` | On | The ship's bell, the zeppelin's horn or the tram, on the Master channel so you hear it with the game in the background. Greyed out while Shortest Path Forever guides: it does this itself. (Switch) |
| **Flash the taskbar icon** `nav.alertFlash` | On | The game's icon flashes while the game is in the background. Greyed out while Shortest Path Forever guides: it does this itself. (Switch) |
| **Show a sample alert** | — | See the banner and hear the boat's bell. (Action) |

### Automation

#### Quests

| Setting | Default | What it does |
|---|---|---|
| **Accept guide quests** `behavior.autoAccept` | On | Only quests in the next steps of your open guides. Hold Shift to skip. (Switch) |
| **Turn in guide quests** `behavior.autoTurnin` | On | Never picks between rewards. Hold Shift to skip. (Switch) |
| **Close offers the guide skips** `behavior.closeSkipped` | On | After Polestar accepts or turns in a quest, closes the quest window the NPC opens next when the guide skips its quests. Hold Shift to keep it open. (Switch) |
| **Warn about missable quests** `behavior.warnClosing` | Off | Before you take a quest that closes another for good, says which in chat and leaves the accept to you. (Switch) |
| **Skip grey quests** `behavior.skipGrey` | Off | Leaves out grey quests and their turn-ins, unless a later quest needs them first. (Switch) |

#### Guides

| Setting | Default | What it does |
|---|---|---|
| **Pick a guide for me** `behavior.autoSelectGuide` | On | Opens the suggested guide when no tab is open. (Switch) |
| **Continue to the next guide** `behavior.autoNextGuide` | On | Loads the follow-up guide in the same tab when one finishes. (Switch) |
| **Where to level next** `behavior.routeChoice` | Let me choose | Where a guide offers more than one zone to continue in (/polestar path). Choices: Let me choose, Take the recommended zone. (Choice) |
| **Trainer reminders** `behavior.trainReminder` | Every 2 levels | A note in the guide window, with the nearest trainer of your class, when new skills are waiting. Choices: Every 2 levels, Every level, Off. (Choice) |
| **Reset guide progress** | — | Manual check-offs and skips, current guide. Shown only when it applies (the addon it works with is installed, or a setting it depends on is on). (Action) |

## Appearance

Opens with `/polestar options appearance`

Colours, type, window frames and the arrow. Everything repaints as you change it; right-click a setting to reset it.

### Colour & type

#### Accent

| Setting | Default | What it does |
|---|---|---|
| **Accent colour** `ui.accent` | false | Click to pick your own, right-click to go back to the scheme's. (Colour) |
| **Class colour** `ui.classAccent` | Off | The accent follows your class: warlock purple, shaman blue, druid orange. Picking your own accent turns this off. (Switch) |

#### Background

| Setting | Default | What it does |
|---|---|---|
| **Colour scheme** `ui.scheme` | Dusk | How deep the night runs. Dusk is the default, Night the darkest, Graphite a neutral grey; EllesmereUI takes its panel colour and accent. Choices: Dusk, Night, Graphite. (Choice) |
| **Background colour** `ui.bgColor` | false | The ground of every Polestar window. Right-click to go back to the scheme's. Text always stays legible: a colour too light for it is darkened. (Colour) |
| **Brightness** `ui.brightness` | 0 | Lifts or lowers every background together. Right-click to reset. (Slider (-1 to 1)) |
| **Background opacity** `ui.bgOpacity` | 0.94 | The background opacity of every Polestar window: how much of the world shows through. Right-click to reset. (Slider (0 to 1)) |

#### Type & motion

| Setting | Default | What it does |
|---|---|---|
| **Font** `ui.font` | The skin's font | The skin's font (the default: the game's own, Fira Sans in Halo), the game's, Inter, Fira Sans, or EllesmereUI's. Choices: The skin's font, Game font, Inter, Fira Sans. (Choice) |
| **Reduce motion** `ui.reduceMotion` | Off | No sliding or popping; fades stay short. (Switch) |

### Windows

#### Frame

| Setting | Default | What it does |
|---|---|---|
| **Skin** `ui.skin` | Polestar | Polestar's own look (the default), Halo (no frame, a soft dark veil, Fira Sans), Hearth (warm game colours), or the game's own art: WoW Forever, Blizzard and Classic. Style, compact mode and the colours you pick work in each. Choices: Polestar, Halo, Hearth, Blizzard, Classic. (Choice) |
| **Window border** `ui.border` | On | The line around every Polestar window. (Switch) |
| **Border colour** `ui.borderColor` | false | Click to pick your own, right-click to go back to the scheme's hairline. (Colour) |
| **Accent border** `ui.borderAccent` | Off | The border takes your accent colour. Picking your own border colour turns this off. (Switch) |
| **Border thickness** `ui.borderSize` | 1 | In screen pixels; a thicker border grows outward. Right-click to reset. (Slider (1 to 4)) |
| **Starlit band** `ui.band` | On | The night sky with its stars across the top of every window. Off: the plain background. (Switch) |
| **Window shadow** `ui.shadow` | On | The soft shadow under every window. (Switch) |

#### Guide window

| Setting | Default | What it does |
|---|---|---|
| **Style** `ui.style` | Standard | Transparent drops every background and border; text is outlined and the controls appear when you hover the window. Choices: Standard, Transparent. (Choice) |
| **Window scale** `ui.scale` | 1 | (Slider (0.6 to 1.6)) |
| **Width** `ui.width` | 340 | (Slider (260 to 560)) |
| **Window opacity** `ui.opacity` | 1 | The whole guide window, text included. The background's own opacity is under Colour & type. (Slider (0.3 to 1)) |

#### Menus

| Setting | Default | What it does |
|---|---|---|
| **Menu scale** `ui.menuScale` | 1 | The guide menu and this window; applies when you let go. Right-click to reset. (Slider (0.7 to 1.4)) |

### Arrow

#### Arrow

| Setting | Default | What it does |
|---|---|---|
| **Arrow style** `nav.arrowStyle` | The skin's arrow | Greyed out while Shortest Path Forever guides: it does this itself. Choices: The skin's arrow, 3D, Flat, Halo, Hearth. (Choice) |
| **Arrow scale** `nav.arrowScale` | 1 | Greyed out while Shortest Path Forever guides: it does this itself. (Slider (0.5 to 2)) |
| **Arrow opacity** `nav.arrowAlpha` | 1 | Greyed out while Shortest Path Forever guides: it does this itself. (Slider (0.2 to 1)) |

#### Colours

| Setting | Default | What it does |
|---|---|---|
| **Arrow colour** `nav.arrowColor` | false | The arrow on its way; the target's pin on the maps and the route's stops wear it too. Right-click to go back to the accent. (Colour) |
| **Arrival colour** `nav.arrowNearColor` | false | The arrow as it closes on the target, and the ring when you arrive. Right-click to go back to jade. (Colour) |

## Map

Opens with `/polestar options map`

What Polestar draws on the world map and the minimap. Quest, rare and travel icons start off.

### Guide & quests

#### Guide

| Setting | Default | What it does |
|---|---|---|
| **Guide pins on the world map** `nav.worldPins` | On | The arrow's target, the stops of its travel route, the step's other goals, the areas their mobs and objects spawn in, and the route lines. (Switch) |
| **Guide pin on the minimap** `nav.minimapPins` | On | The arrow's target, the areas it spawns in, and the route line. (Switch) |
| **Trail dots along the travel route** `nav.trailDots` | On | Moving dots from you to the target on the world map and the minimap, along the travel route, while route lines are off. Greyed out while Shortest Path Forever guides: it does this itself. (Switch) |
| **Minimap button** `maps.minimapButton` | Off | A Polestar button on the edge of the minimap. Click to show or hide the guide, right-click for settings, drag to move it. (Switch) |

#### Quest markers

| Setting | Default | What it does |
|---|---|---|
| **Available quests** `qol.availableQuests` | Off | Mark quest givers with quests you can accept now. (Switch) |
| **Quests above your level** `qol.questLevelWindow` | Your level | Mark quests up to this many levels above yours. (Slider (Your level to Your level)) |
| **Low-level quests** `qol.lowLevelQuests` | Off | Also mark grey quests that are far below your level. (Switch) |
| **World map objectives** `qol.mapObjectives` | Off | Mark mob areas, item sources and objects for quests in your log. (Switch) |
| **Objective areas** `qol.objectiveAreas` | Off | Shade the area each group of mobs or objects spreads over on the world map. (Switch) |
| **Turn-ins** `qol.turnInMarkers` | Off | Mark who to return to once a quest is ready. (Switch) |
| **Minimap markers** `qol.minimapObjectives` | Off | Show the same quest markers on the minimap. (Switch) |
| **Highlight step quests** `qol.guideHighlight` | On | Enlarge and light up the markers of the quests in your guide's current step. (Switch) |
| **Dim other quests** `qol.guideDim` | Off | While a guide runs, fade every quest marker that is not part of its current step. (Switch) |

### Rares & travel

#### Rares and treasures

| Setting | Default | What it does |
|---|---|---|
| **Rares on the world map** `rares.worldRares` | Off | Every known spawn point. Click one to see it in Rares; Shift-click for a waypoint. (Switch) |
| **Treasures on the world map** `rares.worldTreasures` | Off | Every known treasure spot. (Switch) |
| **Rares on the minimap** `rares.minimapRares` | Off | Loads the Codex at login. (Switch) |
| **Treasures on the minimap** `rares.minimapTreasures` | Off | Loads the Codex at login. (Switch) |
| **Hide rares below your level** `rares.hideGrey` | Off | Rares too low to give experience leave the map. (Switch) |

#### Dungeons and travel

| Setting | Default | What it does |
|---|---|---|
| **Dungeon entrances** `maps.dungeonPins` | Off | Marks each dungeon entrance with its level range. Click to open the dungeon's guide, or to set a waypoint when there is none; Shift-click always sets a waypoint. Needs the Codex pack. (Switch) |
| **Flight masters** `maps.taxiPins` | Off | Your faction's and neutral flight masters: green when known, amber when not yet discovered. The tooltip lists destinations and flight times. (Switch) |
| **Boats and zeppelins** `maps.dockPins` | Off | Docks, zeppelin towers and the Deeprun Tram, with where they go. (Switch) |
| **Inns** `maps.innPins` | Off | Innkeepers; the one your Hearthstone is bound to is marked. (Switch) |
| **Travel icons on the minimap** `maps.travelMinimap` | Off | Shows the flight masters, docks and inns turned on here on the minimap as well. (Switch) |

### Zones

#### Zones

| Setting | Default | What it does |
|---|---|---|
| **Unexplored areas** `maps.reveal` | Revealed and tinted | Shows the parts of each zone you have not explored yet, so the whole map is there before you visit. Tinted keeps them apart from where you have been. Choices: Hidden, Revealed, Revealed and tinted. (Choice) |
| **Zone level ranges** `maps.zoneLevels` | On | Shows each zone's level range on the continent and zone maps, coloured by difficulty for your level. (Switch) |

#### Coordinates

| Setting | Default | What it does |
|---|---|---|
| **Coordinates** `maps.coords` | On | Shows your position and the cursor's position under the world map. (Switch) |
| **Coordinates on the minimap** `maps.minimapCoords` | Off | A small readout of your position at the bottom of the minimap. (Switch) |

## Questing

Opens with `/polestar options questing`

Quest information, rewards and gear advice, and the quest buttons.

### Quests

#### Quest database

| Setting | Default | What it does |
|---|---|---|
| **Quest database** `qol.questDB` | On | Quest, NPC and item data for markers and tooltips, loaded when one of them is on (about 5 MB of memory). (Switch) |

#### Tooltips and quest log

| Setting | Default | What it does |
|---|---|---|
| **Quest tooltips** `qol.questTooltips` | On | Name the quests a mob, item or object is for, with your progress. (Switch) |
| **Nameplate icons** `qol.nameplateIcons` | Off | Show a quest icon and your progress, like 3/10, on nameplates of mobs you still need. (Switch) |
| **Quest levels** `qol.questLevels` | On | Show quest levels, like [12], wherever the game lists quests without them. (Switch) |

#### Faster questing

| Setting | Default | What it does |
|---|---|---|
| **Instant quest text** `qol.instantQuestText` | On | Shows quest text at once instead of fading it in (Forever's own option). (Switch) |
| **Skip single-option gossip** `qol.skipGossip` | On | Picks the only option of NPCs without quests. Hold Shift to read it. (Switch) |
| **Faster auto-loot** `qol.fastLoot` | On | Takes the whole corpse at once when auto-loot is on. (Switch) |
| **Hide combat errors** `qol.hideErrors` | Off | Hides "Not enough rage", "Out of range" and cooldown messages. Other errors still show. (Switch) |

#### Party

| Setting | Default | What it does |
|---|---|---|
| **Share my quest progress with my party** `party.share` | Off | Party members who run Polestar see your counts under their quest goals. Nothing goes to chat. (Switch) |
| **Show my party's progress in the guide** `party.show` | Off | Their counts under your quest goals, and who lacks a quest you took. (Switch) |

### Rewards & gear

#### Quest rewards

| Setting | Default | What it does |
|---|---|---|
| **Mark quest rewards** `qol.rewardHighlight` | On | On the reward choices, a green arrow marks each upgrade for your spec (with Gear advice on), a thin frame in your accent colour the one to take, and a coin the one that sells for most. (Switch) |
| **Take the best reward** `qol.rewardAutoPick` | Off | Chooses that reward for you when you complete the quest. Hold Shift to choose yourself. (Switch) |
| **Wear reward upgrades** `qol.rewardEquip` | Off | Puts on what a turn-in gives when it is an upgrade for your spec (with Gear advice on), once it reaches your bags and you are out of combat. Hold Shift at the turn-in to skip. (Switch) |

#### Gear advice

| Setting | Default | What it does |
|---|---|---|
| **Gear advice** `gear.enabled` | On | Score items for your class and talents and point out upgrades. (Switch) |
| **Stat weights** `gear.spec.PALADIN` | Automatic (talents) | Which levelling weights score your items. Automatic follows the talent tree with the most points. Choices: Automatic (talents), Holy (healer), Protection (tank), Retribution. (Choice) |
| **Tooltip comparison** `gear.tooltip` | On | Show on item tooltips how much better or worse an item is than what you wear. (Switch) |
| **Upgrade arrows in bags** `gear.bagArrows` | On | A green arrow on each item in your bags that is an upgrade for your spec, in the game's bags and in Baganator. (Switch) |
| **Reward pick in the guide** `gear.rewards` | On | Under a turn-in step, name the reward to take: an upgrade with its gain, else the best one you can use. The marks on the game's reward panel are under Quest rewards. (Switch) |
| **Reward pick on tooltips** `gear.pickTooltip` | On | On a quest reward's tooltip, say whether it is the upgrade to take. (Switch) |

#### Comparison

| Setting | Default | What it does |
|---|---|---|
| **Upgrade threshold** `gear.minUpgrade` | 1.0% | Smaller gains than this are not called upgrades. (Slider (0.0% to 10.0%)) |
| **Pair with bag items** `gear.useBags` | On | Against a worn two-hander, weigh a one-hander together with the best off-hand piece in your bags. (Switch) |

### Talents

#### Talent plan

| Setting | Default | What it does |
|---|---|---|
| **Talent plans** `talents.enabled` | On | Follow a talent plan for your class and spec (/pole talents). (Switch) |
| **Mark the talent frame** `talents.overlay` | On | A ring on the next talent in your plan and a flag on points the plan does not spend. (Switch) |
| **Pick numbers** `talents.badges` | On | Where each talent comes in your plan's order (#1, #2, ...). (Switch) |
| **Plan in tooltips** `talents.tooltip` | On | A line in each talent's tooltip: where it comes in the plan, or that it is off the plan. (Switch) |
| **Remind me of unspent points** `talents.reminder` | On | A chat line naming the plan's next talent when a point is waiting. (Switch) |

### Buttons

#### Action buttons

| Setting | Default | What it does |
|---|---|---|
| **Quest item button** `qol.itemButton` | On | A button for the current step's quest item, with count, cooldown and range. Bind it under Key Bindings > AddOns. (Switch) |
| **Target button** `qol.targetButton` | On | Targets the current step's mobs by name; each click moves to the next name. Bindable. (Switch) |
| **Rare button** `qol.rareButton` | On | Shows a button that targets a rare Polestar spotted nearby, until it dies or is out of sight. Bindable. (Switch) |
| **Hearthstone button** `qol.hearthButton` | On | Shows your Hearthstone while the guide says to hearth. Bindable. (Switch) |
| **Mark what they target** `qol.markTarget` | Off | The target button and the step key put a raid icon on the mob and the NPC they target; out of combat, a press that finds neither clears your target. Your party sees the icons; in a raid only the leader and assistants can set them. (Switch) |
| **Icon on mobs** `qol.markMob` | \|TInterface\TargetingFrame\UI-RaidTargetingIcon_8:0\|t 8 | A new one each press skips the NPCs' icon and leaves a mob that has one as it is. Choices: \|TInterface\TargetingFrame\UI-RaidTargetingIcon_1:0\|t 1, \|TInterface\TargetingFrame\UI-RaidTargetingIcon_2:0\|t 2, \|TInterface\TargetingFrame\UI-RaidTargetingIcon_3:0\|t 3, \|TInterface\TargetingFrame\UI-RaidTargetingIcon_4:0\|t 4, \|TInterface\TargetingFrame\UI-RaidTargetingIcon_5:0\|t 5, \|TInterface\TargetingFrame\UI-RaidTargetingIcon_6:0\|t 6, \|TInterface\TargetingFrame\UI-RaidTargetingIcon_7:0\|t 7, \|TInterface\TargetingFrame\UI-RaidTargetingIcon_8:0\|t 8, A new one each press. (Choice) |
| **Icon on NPCs** `qol.markNpc` | \|TInterface\TargetingFrame\UI-RaidTargetingIcon_1:0\|t 1 | A new one each press, so the last few NPCs keep theirs. Every press counts, even one that marks nothing. Choices: \|TInterface\TargetingFrame\UI-RaidTargetingIcon_1:0\|t 1, \|TInterface\TargetingFrame\UI-RaidTargetingIcon_2:0\|t 2, \|TInterface\TargetingFrame\UI-RaidTargetingIcon_3:0\|t 3, \|TInterface\TargetingFrame\UI-RaidTargetingIcon_4:0\|t 4, \|TInterface\TargetingFrame\UI-RaidTargetingIcon_5:0\|t 5, \|TInterface\TargetingFrame\UI-RaidTargetingIcon_6:0\|t 6, \|TInterface\TargetingFrame\UI-RaidTargetingIcon_7:0\|t 7, \|TInterface\TargetingFrame\UI-RaidTargetingIcon_8:0\|t 8, A new one each press. (Choice) |
| **Button size** `qol.buttonScale` | 1 | Scale of the quest item, Hearthstone, target and rare buttons. Drag one to move them all. (Slider (0.6 to 1.6)) |
| **Target name position** `qol.buttonTextSide` | Right | Where the target's name shows around the target button: right, left, above or below. Choices: Right, Left, Above, Below. (Choice) |
| **Reset button positions** | — | Put the buttons back in their default spot. (Action) |

## Discovery

Opens with `/polestar options discovery`

Lookup, the dungeon journal and rares: finding things in the world.

### Lookup

#### How to get anything

| Setting | Default | What it does |
|---|---|---|
| **Lookup** `lookup.enabled` | On | Search every item, mount, pet, NPC and quest, and see where it comes from (/pole lookup). (Switch) |
| **Sources on item tooltips** `lookup.tooltip` | On | The best one or two places to get an item, ranked for this character. (Switch) |
| **Alt-click an item for a guide** `lookup.altClick` | On | Alt-click an item link, bag item or loot to open a guide that gets it. (Switch) |
| **Spot other players' mounts** `lookup.mounts` | On | Name the mount of a player you target or point at, and where it comes from (/pole mount). (Switch) |

### Dungeons

#### Dungeon Journal

| Setting | Default | What it does |
|---|---|---|
| **Dungeons** `dungeons.enabled` | On | A page per dungeon and raid: every quest with where to get it, its chain and rewards, the bosses and the entrance. (Switch) |

### Rares

#### When a rare shows up

| Setting | Default | What it does |
|---|---|---|
| **Rares** `rares.enabled` | On | Watch for rare NPCs and treasures and keep when you last met them (/pole rares). Their map pins are under Map, off by default. (Switch) |
| **Alert for rares** `rares.alerts` | On | A card with its name, level and distance, and a waypoint to it. (Switch) |
| **Alert for treasures** `rares.treasureAlerts` | On | Treasures the client marks on the minimap. (Switch) |
| **Once per rare every** `rares.cooldown` | 10 | The same rare stays quiet this long after an alert. (Slider (1 to 60)) |
| **Alert stays for** `rares.toastSeconds` | 20 | Hovering the alert holds it. (Slider (5 to 60)) |
| **Alert during combat** `rares.combatAlerts` | Off | Off: an alert waits for the fight to end, if the rare was seen in the last minute. (Switch) |
| **Play a sound** `rares.sound` | On | One sound with each alert. (Switch) |
| **Sound** `rares.soundKit` | Raid warning | Played through the Master channel. Choices: Raid warning, Ready check, Boss whisper. (Choice) |
| **Show a sample alert** | — | See where the alert sits; drag it to move it. (Action) |

#### How rares are noticed

| Setting | Default | What it does |
|---|---|---|
| **Minimap markers** `rares.vignettes` | On | Rares and treasures the client marks on the minimap (vignettes), with their exact distance. (Switch) |
| **Nameplates** `rares.nameplates` | On | A rare's nameplate coming into view. Needs enemy nameplates on. (Switch) |
| **Your target** `rares.target` | On | Targeting a rare. (Switch) |
| **Under the cursor** `rares.mouseover` | On | Pointing at a rare in the world. (Switch) |

#### History

| Setting | Default | What it does |
|---|---|---|
| **Forget rares met on this realm** | — | Clears the Seen list, alert cooldowns and the glow on recently seen pins. (Action) |

## Quality of Life

Opens with `/polestar options qualityoflife`

Small conveniences: travel, invitations, merchants and trackers.

### Travel

#### Flight masters

| Setting | Default | What it does |
|---|---|---|
| **Open the flight map** `qol.flightAutoOpen` | On | Talking to a flight master opens the map directly. Hold Shift for the gossip. (Switch) |
| **Mark the route's destination** `qol.flightHighlight` | On | Marks where the travel route flies next on the flight map. You still choose the flight. (Switch) |

#### Hearthstone

| Setting | Default | What it does |
|---|---|---|
| **Set your home at the guide's inn** `qol.autoBind` | Off | When the step sets your home and you talk to its innkeeper, binds your Hearthstone there. Never at another inn. Hold Shift to skip. (Switch) |

#### Flight timer

| Setting | Default | What it does |
|---|---|---|
| **Flight timer** `maps.flightTimer` | On | While flying, shows the destination and the time left. Learns each route's real duration for this character; drag to move. (Switch) |
| **Forget learned flight times** | — | Clears this character's recorded flight durations; estimates are used until they are flown again. (Action) |

#### Death

| Setting | Default | What it does |
|---|---|---|
| **Corpse or Spirit Healer** `qol.deathHelper` | On | As a ghost, points the arrow at the faster way back: your corpse or the nearest Spirit Healer. (Switch) |
| **Release in battlegrounds** `qol.autoReleasePvP` | Off | Releases your spirit at once when you die in a battleground, unless you can resurrect yourself or someone offers to. Hold Shift to stay. (Switch) |

### Social

#### Requests

| Setting | Default | What it does |
|---|---|---|
| **Accept summons** `qol.acceptSummon` | Off | Takes a summon at once, unless you are in combat. Hold Shift to decide yourself. (Switch) |
| **Accept resurrections** `qol.acceptResurrect` | Off | Takes a resurrection as soon as it can, unless the caster is in combat. Never in Hardcore. Hold Shift to decide yourself. (Switch) |
| **Join friends' parties** `qol.acceptPartyFriends` | Off | Accepts party invitations from friends, Battle.net friends and your guild, unless joining would leave a queue. Hold Shift to decide yourself. (Switch) |

#### Blocking

| Setting | Default | What it does |
|---|---|---|
| **Decline other party invitations** `qol.declinePartyStrangers` | Off | Declines party invitations from anyone who is not a friend or in your guild. (Switch) |
| **Decline guild invitations** `qol.declineGuildInvites` | Off | Declines guild invitations, except from friends. (Switch) |
| **Decline duels** `qol.declineDuels` | Off | Declines duel requests, except from friends and your guild. (Switch) |

### Vendors

#### Merchants

| Setting | Default | What it does |
|---|---|---|
| **Sell grey items** `qol.sellJunk` | On | Sells Poor-quality items when a merchant opens and prints the total. Never sells anything else. (Switch) |
| **Repair** `qol.autoRepair` | On | Repairs all gear at merchants who can, when you can afford it. Hold Shift to skip. (Switch) |
| **Guild bank first** `qol.repairGuild` | Off | When your guild rank may, the guild bank pays for repairs and your money covers the rest. (Switch) |
| **Buy for the guide** `qol.buyGoals` | Off | When the step asks you to buy something and the merchant sells it, buys what you still need after selling and repairing. Optional buys and anything over 50g are left to you. Hold Shift to skip. (Switch) |

#### Trainers

| Setting | Default | What it does |
|---|---|---|
| **Learn new spells** `qol.trainAll` | Off | Learns every spell a class trainer offers that you can afford, and prints the total. Profession trainers are left alone. Hold Shift to skip. (Switch) |

### Trackers

#### Experience

| Setting | Default | What it does |
|---|---|---|
| **XP tracker** `qol.xpTracker` | On | XP per hour, time, kills and quests to level, and level splits (/pole xp). (Switch) |
| **Guide level on the XP bar** `qol.xpTargetMark` | On | A mark at the end of the game's XP bar with the level the guide wants you to reach before it moves on, and how many levels away that is when it is more than one. (Switch) |
| **Reset session** | — | Start this session's XP per hour from zero. (Action) |

#### Instances

| Setting | Default | What it does |
|---|---|---|
| **Track instances** `maps.instances` | On | Records dungeon and raid entries, time and experience per run. /pole instances lists them. (Switch) |
| **Compact display** `maps.instanceDisplay` | Off | Shows the hourly instance count and the current run while it matters; drag to move. (Switch) |

#### Instance limits

| Setting | Default | What it does |
|---|---|---|
| **Instances per hour** `maps.perHour` | 5 | Classic allows 5 new instances per hour per account. Forever may differ; adjust if it does. (Slider (1 to 10)) |
| **Instances per day** `maps.perDay` | 30 | Classic Era allows 30 new instances per 24 hours per account; 0 ignores the daily cap. Forever may differ. (Slider (0 to 60)) |
| **Clear instance history** | — | Forgets recorded entries and runs (the server's own limit is not affected). (Action) |

## Integrations

Opens with `/polestar options integrations`

Settings for other addons Polestar works with, shown when they are installed.

### EllesmereUI

| Setting | Default | What it does |
|---|---|---|
| **Match EllesmereUI accent** `ui.matchAccent` | On | Follow EllesmereUI's accent, live. Picking your own accent turns this off. Shown only when it applies (the addon it works with is installed, or a setting it depends on is on). (Switch) |
| **Match EllesmereUI font** `ui.matchFont` | Off | Follow EllesmereUI's font, live. Choosing another font turns this off. Shown only when it applies (the addon it works with is installed, or a setting it depends on is on). (Switch) |

### TomTom

| Setting | Default | What it does |
|---|---|---|
| **Let other addons set waypoints** `nav.answerTomTom` | Off | Without TomTom installed, waypoints other addons set through TomTom, and /way, point Polestar's arrow. Addons that expect TomTom's own settings may not work with it on. Greyed out while Shortest Path Forever guides: it does this itself. (Switch) |
| **Follow TomTom's arrow** `nav.followTomTom` | Off | With TomTom installed, the arrow goes wherever TomTom's arrow points, routed like any goal. (Switch) |

### Shortest Path Forever

| Setting | Default | What it does |
|---|---|---|
| **Hand guiding to Shortest Path Forever** `nav.spfHandoff` | Off | Shortest Path Forever's arrow, route and journey take you to each goal. Polestar's arrow, route lines, journey steps, travel button, transport alerts, map clicks and /way step aside; the guide window and map pins stay. Off: Polestar guides, and steps aside only while a journey you started in Shortest Path Forever runs. Shown only when it applies (the addon it works with is installed, or a setting it depends on is on). (Switch) |

### The community quest database

| Setting | Default | What it does |
|---|---|---|
| **Show planned turn-ins in the community quest database** `routePlan.<quest-db>` | Off | Completed quests in the community quest database's tracker show their Polestar turn-in step. Earlier, skipped and unplanned hand-ins are flagged. Shown only when it applies (the addon it works with is installed, or a setting it depends on is on). (Switch) |

## Community guides

Opens with `/polestar options guidepacks`

Guides made by other players: switch them on or off, and choose where suggestions come from.

This page is drawn by its own code: it shows status and actions rather than settings.

## Gamepad

Opens with `/polestar options gamepad`

Play Polestar with a gamepad: its windows, its buttons and your bindings. The bindings take keys too.

### Navigation

#### Your gamepad

| Setting | Default | What it does |
|---|---|---|
| **Button names** `gamepad.glyphs` | Automatic | The names and shapes Polestar shows for your gamepad's buttons. Automatic reads them off the gamepad. Choices: Automatic, Xbox (A, B, X, Y), PlayStation (shapes). (Choice) |
| **Navigate Polestar's windows** `gamepad.navigate` | On | While a Polestar window is open, the D-pad moves through it, A selects, B closes, LB and RB change tabs, Y restores a default. Out of combat; the game gets every button back when the window closes. (Switch) |
| **Button hints** `gamepad.hints` | On | A bar under the window says what each button does, and B sits on the close button. (Switch) |
| **Use with the keyboard and mouse** `gamepad.withMouse` | Off | Off, Polestar uses the gamepad only with the game's gamepad interface (Options, Gamepad, Enable Gamepad UI). On, also with the keyboard and mouse interface, while the gamepad is turned on in the game's options and plugged in. (Switch) |

### Key bindings

#### The guide

| Setting | Default | What it does |
|---|---|---|
| **Next step** | — | (Key binding) |
| **Previous step** | — | (Key binding) |
| **Browse the guide with the gamepad** | — | The guide window holds the gamepad until B: the D-pad picks a line, A points the arrow there or uses the item, X shows its details, LB and RB change steps, Y minimizes the window. A window that opened by itself, such as a route choice, waits for this button before it takes the gamepad. (Key binding) |
| **Toggle guide window** | — | (Key binding) |

#### Windows

| Setting | Default | What it does |
|---|---|---|
| **Open the guide menu** | — | (Key binding) |
| **Open Polestar options** | — | (Key binding) |
| **Report a problem** | — | (Key binding) |

#### Quest buttons

| Setting | Default | What it does |
|---|---|---|
| **Use quest item** | — | (Key binding) |
| **Target quest mob** | — | (Key binding) |
| **Target rare** | — | (Key binding) |
| **Use Hearthstone** | — | (Key binding) |
| **Use the step button** | — | Step action: NPC, quest item, mob or Hearthstone (Key binding) |
| **Use the travel button** | — | Use the route's Hearthstone or teleport (Key binding) |

## Recorder

Opens with `/polestar options recorder`

The data recorder for guide authors.

This page is drawn by its own code: it shows status and actions rather than settings.

## About

Opens with `/polestar options about`

Why Polestar exists, its commands and its credits.

This page is drawn by its own code: it shows status and actions rather than settings.

## Settings without a control

Defaults the addon keeps that no row above shows: window positions, remembered choices and values other settings derive from. Reset page in the options window clears a page; these reset with them.

### 26 saved settings

| Key | Default |
|---|---|
| `behavior.suggestFrom` | `"guides"` |
| `gear.spec.DRUID` | `"auto"` |
| `gear.spec.HUNTER` | `"auto"` |
| `gear.spec.MAGE` | `"auto"` |
| `gear.spec.PRIEST` | `"auto"` |
| `gear.spec.ROGUE` | `"auto"` |
| `gear.spec.SHAMAN` | `"auto"` |
| `gear.spec.WARLOCK` | `"auto"` |
| `gear.spec.WARRIOR` | `"auto"` |
| `maps.minimapButtonAngle` | `225` |
| `maps.timerPos` | `false` |
| `maps.trackerPos` | `false` |
| `nav.journeyOpen` | `true` |
| `nav.lineStyle` | `"dots"` |
| `nav.openmapDots` | `true` |
| `nav.sparkleColor` | `"gold"` |
| `nav.sparkleDensity` | `5` |
| `nav.sparkleFlow` | `0.5` |
| `nav.sparkleIntensity` | `0.75` |
| `nav.sparkleLater` | `false` |
| `nav.sparkleMax` | `140` |
| `nav.sparkleSize` | `14` |
| `nav.sparkleSubtlety` | `0.35` |
| `rares.ignored` | `false` |
| `rares.toastPoint` | `false` |
| `ui.pickerFaction` | `"auto"` |

---

Next page: [Key bindings](https://polestar.guide/docs/reference/bindings.md) · Every docs page: https://polestar.guide/llms.txt · All docs in one file: https://polestar.guide/llms-full.txt