Item filter

An Item filter allows a player to customise the appearance of items on the ground, as well as hide unwanted items.

Early Access

Item filters seem to work the same way they did in Path of Exile 1 so far. Filter settings are documented on the item filter page of the PoE 1 site; settings that are exclusive to PoE 2 are labelled "PoE2-only". The following code is a working example for PoE 2:

   Show
       BaseType == "Riveted Mitts"
       SetFontSize 45
       SetTextColor 255 255 255 255
       SetBorderColor 240 100 0 255
       SetBackgroundColor 0 0 0 255

Placing a file with this content in "%USERPROFILE%\Documents\My Games\Path of Exile 2" (Windows 10+, if you did not move "My Documents" from its default location) makes it available in game in the options window under "Game/General/Item Filter". The game only loads filter files with the file extension '.filter'.

A filter file consists of any number of blocks that are processed from top to bottom. Each block either shows or hides the items specified by it. When a block matches an item, by default, no further blocks are evaluated for this item. This can be changed using the 'Continue' keyword in the block.

By default, no items are hidden.

See Also

PoE 1 wiki - Item filter guide

Version history

Version	Changes
0.3.0	Added support for the 'import' keyword in item filters. Added support for multiple custom sounds in item filters.
0.2.0h	Added "UnidentifiedItemTier" as a filter option for Item Filters.
0.1.1	Item filters can now be used on consoles by subscribing to a filter on the Path of Exile website. A link to set up an item filter is now provided in the filter section of the settings menu, under the Game tab.
0.1.0	Introduced to the game.