PoE Upgrade Checker logoPoE Upgrade Checker Download

Setup guide

Set up PoE Upgrade Checker in about five minutes.

Everything from the download to your first F2: importing your build from Path of Building or poe.ninja, prices, the upgrade check, the price check, hotkeys and settings, for Path of Exile 2 and Path of Exile 1.

The PoE Upgrade Checker popup in Path of Exile 2: Path of Building's verdict on a pair of gloves, next to the item

In this guide

  1. What you need
  2. Install
  3. Set up the game
  4. First launch
  5. Import your build
  6. poe.ninja: prices and builds
  7. Save your gear
  8. Path of Exile 2
  9. Path of Exile 1
  10. Use the upgrade checker
  11. Find upgrades on trade
  12. Use the price checker
  13. Hotkeys
  14. Settings
  15. Troubleshooting

What you need

1. Install

  1. Download PoE-Upgrade-Checker-Setup-x.y.z.exe from the newest release and run it. It installs for your Windows user only, so it needs no admin rights, and it updates itself.
  2. Windows SmartScreen may say it doesn't recognise the app, because the installer isn't code-signed. Click More info, then Run anyway. The app is open source on GitHub, and every release is built there by GitHub Actions.
  3. Prefer nothing installed? The Portable .exe on the same page runs from anywhere, but doesn't update itself.

The app lives in the system tray (by the clock). Closing the main window keeps it running there; right-click the tray icon for its menu: Settings & gear… opens the main window, and it also has the results window, the loot filter editor, the search string builder, Open log, Pause watching and Quit.

Had PoE2 Upgrade Checker? It's the same app, renamed when it started supporting PoE1. It updates itself to the new name and keeps your characters, builds and settings.

2. Set up the game

  1. In the game, open Options → Graphics and set Windowed Fullscreen. In exclusive fullscreen the popup can't show over the game: it's the most common reason the app seems to do nothing.
  2. Start the game normally, not as administrator. Windows doesn't let a normal app send Ctrl+C to a game running as administrator.
  3. Optional: turn on advanced item descriptions in the app (Settings → Use advanced copy). The app then copies with Ctrl+Alt+C, and the popup shows each mod's tier and roll, and open prefixes and suffixes for crafting.

3. First launch: the setup guide

The first time it starts, a short guide opens. You can run it again any time from My gear → Setup guide.

  1. Welcome: the Windowed Fullscreen reminder, and a tick box for anonymous usage counts (numbers only, no account, items or builds; you can turn it off here or in Settings).
  2. Your game and league: pick Path of Exile 2 or Path of Exile 1, and the league for prices and trade searches. Leave it on The current league and the app moves to the next league by itself; pick Standard or a Hardcore league if that's where you play.
  3. Your build: paste your Path of Building code or pobb.in link (more in the next section). No build in PoE2? Pick the closest gear score profile instead.
  4. Your hotkey: it says whether F2 is working, lets you pick where the popup appears, and Show a test popup checks it can draw.
  5. Your gear: how to save what you're wearing.
  6. You're set: it waits for your first item. Hover one in game and press F2: it says It works when the app got it.

4. Import your build

This is the step that makes the verdicts exact. With your build loaded, the app runs Path of Building's own calculations on every item: what it does to your damage (or your minions'), effective HP, resistances, Spirit or mana, for any class and any skill.

My gear: every slot with its gear score, and Your build in Path of Building with the box to paste a pobb.in link or export code, and Import
My gear: paste the code or link on the right and click Import.

From Path of Building

  1. Open your build in Path of Building 2 (PoE2) or Path of Building Community (PoE1). New to it? See Path of Building for PoE2.
  2. Click Import/Export Build, then Generate, then Copy. Or share it to pobb.in and copy that link.
  3. In the app, open My gear, paste it in Your build in Path of Building and click Import. The first import takes a few seconds while Path of Building starts.

Keep it in sync: a pobb.in link can be read again with one click. Or use Or link a build file… and pick the file Path of Building saves (Documents\Path of Building\Builds): the app reads it again every time you save in Path of Building.

From poe.ninja builds

Copying a league starter or a top player's character? Find it on poe.ninja builds (PoE2) or poe.ninja builds for PoE1, open the character, and use its Path of Building export to copy the build code. Paste that on My gear and click Import. The app then judges every item against that exact character's tree, skills and gear. The Build & stats page links to poe.ninja builds too.

From a guide's .build file

Following an in-game build guide with no Path of Building link? Use Or link a build file… and pick the guide's Build Planner file (Documents\My Games\Path of Exile 2\BuildPlanner). The tree, skills and the guide's gear become a Path of Building build, with a stage picker for levelling guides, or Follow my level.

Then check two things

Several characters? Use Manage → New character above the character picker in the sidebar, and the picker to switch. Each one keeps its own build, gear, resistances and League start progress.

5. poe.ninja: prices and builds

There's nothing to sign up for. The app gets poe.ninja's prices by itself:

For a look at the whole market, the site has a free currency prices page for both games, from the same cache. PoE Upgrade Checker isn't made by or affiliated with poe.ninja.

6. Save your gear

Importing a build fills your slots with Path of Building's items. To compare against what you really wear:

  1. Open your character screen in game (C).
  2. Hover each equipped item, press F2 and click Set as … in the popup. Items you copy in game replace Path of Building's in the calculation.
  3. My gear shows a checklist of the slots you've saved.

Faster: pick a Save as equipped key in Settings, then hover an item you wear and press it: it's saved in its slot with no click. And when you craft on a saved item, checking it again saves it as it is now.

7. Path of Exile 2 setup

8. Path of Exile 1 setup

PoE1 is fully supported, and set up the same way:

9. Use the upgrade checker (F2)

Hover any item, in your stash, inventory, a vendor's window or on the ground, and press F2. The app presses Ctrl+C once for you, reads the item, swaps it into your build in Path of Building, and shows the popup next to it. While it works the popup says Reading item…, then CHECKING… for a moment while Path of Building calculates.

Two popups: LOSES RESISTANCE, lightning resistance 75% to 54%; and LOSES DAMAGE, minion DPS down 15.3%
Two red verdicts: the first item drops lightning resistance off the cap, the second costs 15% of the build's minion damage.

Here is everything the popup can show, from top to bottom.

The item's name

The name in the game's rarity colour, then the base type, the item class and the item level (ilvl). It's the item you copied, so you can tell you checked the right one.

The verdict

The big word is Path of Building's answer to is this better than what I wear in that slot?

UPGRADE
Clearly better for your build: +3 points or more. Wear it.
SMALL UPGRADE
A little better: +1 to +3 points. Worth it if it's cheap or you have nothing better to spend on.
SIDEGRADE
About the same: within 1 point either way. It's better in some ways and worse in others, and they cancel out.
DOWNGRADE
Worse than what you wear.
UPGRADE, BUT…
The numbers go up, but something breaks: you'd be short of Spirit for your minions or auras, you couldn't meet an attribute requirement, you'd lose 3% or more movement speed, or (PoE1) it has fewer links than the gems you socket there. The reason is written under it.
LOSES RESISTANCE
It drops a resistance off the cap (or further under it). Never called an upgrade, however good the rest is: an uncapped resistance gets you killed. The line under it says exactly what drops.
LOSES DAMAGE
It costs more than 5% of your damage, usually because it's missing a damage mod your item has. Never called an upgrade, however much life or resistance it adds.
EMPTY SLOT
You have nothing saved in that slot, so anything is better. Click Set as … if you're wearing it.
EQUIPPED
It's the item you have saved in that slot.
NOT JUDGED
The app can't judge this kind of item (for example a PoE1 cluster or timeless jewel, or an unidentified item). It can still price it.
UNIQUE
A unique with no build loaded: uniques have fixed mods, so they get no gear score. Load your build and they get a real verdict.

You can turn each safety check off under My gear → Priorities: Cap my resistances first, Never lose damage, Never run short of Spirit, Keep attribute requirements met and Keep my movement speed.

The score: "+12.4 pts for your build"

Next to the verdict is Path of Building's score for the item. It's the % change to your damage and your effective HP, weighted 60/40 by default, plus half a point for every resistance point it adds toward a cap you're short of. So +12.4 pts means roughly a 12% better build. Move the Damage – Survivability slider on My gear to weigh them differently, for example toward survivability for Hardcore.

Under it, vs Doom Vise names the item it was compared with. Rings are tried in both ring slots and compared with the one it beats more; jewels are tried in every jewel socket on your tree, and the verdict says which socket (vs Entropy Star (Socket #2)). A two-handed weapon is compared with your weapon and offhand together.

Red lines: what you'd lose

A popup with a red border always has one of these. On the trade results these items go to the bottom.

Path of Building's numbers

The line marked PoB is what Path of Building calculated with your build, compared with what you wear now:

Under that come the totals that change, each as before → after: Speed (movement speed), Hit (your skill's average hit), ES, Life, Runic Ward (Ward in PoE1), Spirit, Mana, and each resistance, marked ✓ capped, (under cap) or off the cap. A line starting with a warning sign lists anything else that breaks, such as running short of Spirit or an attribute requirement.

Colours: blue is better, red is worse, grey is a change your build doesn't care about. With Settings → Colour-blind friendly colours, worse is orange instead of red.

At 20% quality

Armour and weapons under 20% quality are judged a second time at 20%: At 20% quality: +6.1% for your build (UPGRADE) · 8% now. That's what a few Armourer's Scraps, Blacksmith's Whetstones or Arcanist's Etchers would make it.

Price and keep, sell or vendor

Gear score (PoE2, without a build)

Without a Path of Building build, PoE2 items get a gear score from 0 to 100 instead: how good the item is in that slot for your kind of build, where 100 is about the best it can roll. The grade is S (85+), A (70+), B (55+), C (40+) or D. 45 C · gear score · yours 56 means it scores 45 and the item you wear scores 56. Click why? for the points each stat gave, how high each rolled, what's missing and which mods do nothing for you. Resistances only count up to your cap.

Crafting lines

With advanced copy on (Settings), the popup knows the item's affixes:

The buttons

The popup closes when you move the mouse away, click ×, or after the time set in Settings. Esc is left to the game.

Other things F2 works on

10. Find upgrades on trade

Trade results judged by Path of Building, each listing with its verdict, resistances first
Every listing is checked with your build before you see it.
  1. Click Find upgrades in the popup, or next to any slot on My gear. Path of Building weights the search by what every mod is worth to your build, and checks each listing exactly.
  2. Set a price range on the Find upgrades page, for example 5 to 20 divines, and the sellers: Instant Buyout + In Person by default.
  3. Results open in the app's results window, sorted resistances first or by best upgrade, best value, or cheapest. Upgrades only hides the rest.
  4. Travel to hideout on Instant Buyout listings, or Copy whisper for the rest. Esc hides the window and Ctrl+Shift+D brings it back.

Sign in (optional): Settings → Trade site account opens pathofexile.com's own login in a separate window. Signed in, searches can weigh more stats and Travel to hideout works. Without it everything else still works.

More ways to search: Same stats or better, Craftable bases, Custom search, Best uniques, and Where to spend in the sidebar, which searches every slot in your budget and ranks what each divine buys you. Save a search and tick Alert to get a notification when new listings appear.

11. Use the price checker (F3)

Price card for a stack of Divine Orbs: the poe.ninja price, its 7-day change and a suggested listing price
F3 on a stack of currency: the poe.ninja price, the stack's worth and the trend.
  1. Hover an item and press F3. A small popup shows only its price, without the upgrade check.
  2. Currency, fragments, gems, divination cards and uniques are priced from poe.ninja: each, the whole stack, and the 7-day trend.
  3. Rares, waystones, maps and tablets are priced from the trade site, searched the way buyers search (total resistances, life, attributes, defences or DPS, and the worthwhile mods). Only recent listings from sellers who are online count, and price-fixing baits are left out.
  4. It says how sure it is: solid price (plenty of close, recent listings at similar prices), rough price, or a guess. When nothing close is listed you get a range instead of one made-up number.
  5. Every listing is compared with your item, so better ones don't push your price up, and your own listing is left out. The same item again within an hour answers at once.

F2 or F3? F2 does everything: the upgrade verdict, then the price on the same popup when you click What's it worth?. F3 skips the build check for a quick answer while you sort loot. Change or turn off F3 under Settings → Hotkeys.

Too low / About right / Too high under a price tells the app how far off it was, which helps tune the price checks.

Selling it: the popup suggests a listing price just under the market and Copy price note (~price 4 divine) to paste into the item's note in a premium stash tab. Items you copy a note for go on the For sale list (Check an item page), which checks whether they're still listed and how your price compares.

Picking the stats yourself: in the full popup, Price by chosen stats… lets you choose exactly which stats and minimums to match. And about 3 hours after a trade price check the app looks again and tells you how many of those listings were gone: what sold, and at what asking prices.

12. Hotkeys

Change any of them under Settings → Hotkeys: click the box, press the keys, then Save. F-keys work best: with WASD movement, a letter key would also move your character.

KeyWhat it does
F2Check item: the upgrade verdict, price and trade buttons for the item under the mouse
F3Price only: a small popup with just the item's price
Ctrl+Shift+DShow or hide the trade results window
Ctrl+Shift+LShow or hide the League start overlay (set on the League start page)
Off until you pick oneSave as equipped: save the item you wear under the mouse in its slot
Off until you pick oneSearch strings: copy a search for the game's search box, press again for the next
Off until you pick oneLoot filter editor and Search string builder overlays

The only key the app sends to the game is one copy (Ctrl+C, or Ctrl+Alt+C with advanced copy) per press. Search strings and chat commands only go on your clipboard for you to paste. If another program holds a key, the app tells you and offers Pick other keys.

13. Settings

Your data stays on your PC in %APPDATA%\PoE2 Upgrade Checker. More in Fair play and privacy.

Troubleshooting

Still stuck? Ask on our Discord with a screenshot and the log (tray → Open log), or email support@poe2upgrade.com.

I press F2 and nothing happens

Set the game to Windowed Fullscreen, check the tray menu says Hotkey: F2, and start the game normally, not as administrator. Settings → Show a test popup checks the popup can draw at all, and the log (tray → Open log) says what happened on each press. When F2 finds nothing, the popup usually says why: the game wasn't the active window, or the mouse wasn't over the game.

The app says the hotkey is taken

Another overlay or tool has registered the same key. Click Pick other keys in the warning, or set another key under Settings → Hotkeys. F-keys nobody else uses (F4–F8) are a good choice.

The import fails or says it can't read the build

Paste the whole code, from Path of Building 2 for PoE2 or Path of Building Community for PoE1, and make sure the character in the app is for the same game. A pobb.in link must be the build's page, like https://pobb.in/abc123. The first import takes a few seconds while Path of Building starts; if it still fails, send the log on Discord.

The verdicts look wrong for my build

They're only as good as the build you give it. Pick the right main skill on the Character page, check Path of Building's Configuration tab (charms, buffs, enemy settings), and save the items you really wear with Set as …. If it still looks wrong, share your pobb.in link and the item on Discord.

Prices are missing or look old

Check the league on Find upgrades: prices are for that league only. Rare items aren't on poe.ninja, so they're priced from the trade site; if the trade site is busy, try again in a minute. Early in a new league poe.ninja has little data, so prices move a lot.

Trade searches fail or say "rate limited"

The trade site limits how often anyone can search. The app paces itself to those limits, so wait a minute and try again. Signing in under Settings → Trade site account allows bigger searches.

The popup covers the item tooltip

Pick a side of the screen under Settings → Popup → Position, or drag the popup by its name: it stays where you put it.

Windows warned me about the installer

The installer isn't code-signed, so SmartScreen doesn't know it yet. Click More info, then Run anyway. The source and the release builds are on GitHub.

Is it safe? Can I get banned?

It never reads game memory, never changes game files and never injects anything. Its only input to the game is one Ctrl+C per key press, the same as copying an item yourself. It's a fan project, not affiliated with Grinding Gear Games. More in Fair play and privacy.

Set up? Press F2.

Download PoE Upgrade Checker

Free and open source. Windows 10/11, Linux (experimental). Path of Exile 2 and Path of Exile 1. Questions? Join our Discord.