Consider helping out in updating the wiki for 3.8.0 - see Path of Exile Wiki:To-do list/3.8.0.

Game data updates to the wiki have been started.


A system has been added that will automatically add divination cards and other items to the item acquisition sections where appropriate. Entries added by this system will be shown as automatic in the item acquisition section.

Some pages will need to be updated to include upgraded_from_disabled=true if they are not eligible for the system.

Some further details on what needs to be done can be found on Path of Exile Wiki:To-do list/Automatic upgraded from and issues can be posted on the talk page.

Item filter

From Path of Exile Wiki
Jump to: navigation, search

Grinding Gear Games implemented Item filters into the Path of Exile UI so players can customize how the game client displays items on the ground. This feature remedies the time it takes to find useful / valuable items in game. For those who don't have experience with programming or website development, the code for the item filters might seem complex. However, the information provided here will open the door so that you, the player, can understand how the item filters work.

Using an existing filter

Step 1
Go to: %USERPROFILE%/Documents/My Games/Path of Exile/
For example:
Step 2
Locate an existing filter, i.e. from List of item filters or elsewhere.
Step 2A - Copying file
If the item filter is supplied as downloadable file with the .filter extension, you can simply download it and save it in the folder.
Step 2B - Copying Contents
Create a text file with the name you want your Filter to have. When you Save this file, be sure to select 'Save As' and set the file type to "All Files (*.*)". Copy the contents of the filter into the file.
Then save the file as: filtername.filter
It should look like this if done correctly
If you cannot see your file extension, Show/Hide File extensions in Windows
Step 3
Go to the in-game Options menu and click on the UI tab. You should see this new option, located at the very bottom of the list:
If your Filter is not a .filter file, or it is not located in the same folder as your production_Config.ini file, you won't see this option.
Step 4
Clicking 'Reload' will display this message if the Filter is working correctly:



Please consider the following when reading this wiki page:

  • Replace the values in the brackets with a single value
  • x-y (i.e. 0-255) is used to show a range of valid values
  • Values enclosed with [] are optional; remove the []
  • Values enclosed with <> are required; remove the <>

Basic Syntax

The basic syntax of a script is a collection of Show and Hide blocks that each specify conditions. Anything matched by a Show block will be shown and anything matched by a Hide block will be hidden. If there are multiple conditions in a block then all of them must be matched for the block to match an item.

Every block must start with either Show or Hide, and any conditions in that block must start on the next line; indentation is optional. A line with only Show or Hide with no conditions is an "empty block," and matches ALL items, which means that a Hide at the end of the file effectively hides everything that wasn't specifically shown.

The blocks are prioritized in the order they come in the file, meaning that condition blocks that appear earlier in the file take precedence, applying their effects even if their conditions overlap with later blocks. Effectively, the script reads the filter file until it finds the first block that matches the item in question, follows that block's instructions, and then terminates.

# For example, the following would hide all normal rarity items, but fail to show currencies:
    Rarity Normal
    Class Currency

# To fix this, move more specific blocks earlier in the file, and save the most general for last. This would show currencies, but hide other normal rarity items:
    Class Currency
    Rarity Normal


A line starting with # will be considered a comment and will be ignored.


Name Notes
Show If all conditions are matched, show the item and do any actions specified
Hide If all conditions are matched, hide the item and do any actions specified


The following Operators can be used with numeric conditions. Note that for equal operations there is no operator required.

Operator Notes
< Less than
<= Less than or equal to
> Greater than
>= Greater or equal to
= Equal to



  • Ranges in parentheses are plausible values, but not enforced.
  • Every condition can have multiple values separated by a space.
  • If a multi-word value contains whitespace, it must be encapsulated in quotation marks, or else it will be parsed as separate (and possibly invalid) values.
Name Valid Values Notes
ItemLevel [Operator] <Level> Numeric Level (0-100) The item level the item was generated at.
DropLevel [Operator] <Level> Numeric Level (0-100) The level that the item starts dropping at.
Quality [Operator] <Quality> Numeric Quality (0-20) The amount of quality on the item.
Rarity [Operator] <Rarity> Normal, Magic, Rare, Unique Rarity of the item.
Class <Class> Full or partial item class name The item class. Specifying part of a class name is allowed and will match any classes with that text in the name. So for example "One Hand" will match both "One Hand Sword" and "One Hand Axe"
BaseType <Type> Full or partial item name The base type of the item. Specifying a part of a base type name is allowed and will match any of the base types with that text in the name.
Prophecy <Type> Full or partial prophecy name The prophecy name. Specifying a part of a prophecy name is allowed and will match any of the prophecies with that text in the name. Prophecies have the Class type "Stackable Currency".
Sockets [Operator] <Sockets> Numeric Number of Sockets (0-6) Total number of sockets that the item has.
LinkedSockets [Operator] <Links> Numeric Number of Links (0-6) The size of the largest group of linked sockets that the item has.
SocketGroup [Group] R, G, B, W A group of linked sockets that contains the specified combination. Each letter is short-hand for the colour (i.e. Red = R). For example, RRG will match any group that contains two red sockets linked with a green socket.
Height [Operator] <Value> Numeric number of slots (1-4) The number of slots the item takes on the Y-axis (verical axis), i.e. the height of the item. [1]
Width [Operator] <Value> Numeric number of slots (1-2) The number of slots the item takes on the X-axis (horizontal axis), i.e. the width of the item.
HasExplicitMod <Value> Full or partial item name Filter by mods on an item by name. For example: [HasExplicitMod "Tyrannical" ] (Tyrannical=Local Physical Damage 155 to 169%)
AnyEnchantment <Boolean> True or False If an item has any enchantment
HasEnchantment <Value> Full or partial name of enchantment Filter by enchantments
StackSize [Operator] <Value> Numeric number of slots (1-n) Currency stack size
GemLevel [Operator] <Value> Numeric number of slots (1-21) Gem Level
Identified <Boolean> True or False If an item is identified or not.
Corrupted <Boolean> True or False If an item is corrupted or not.
ElderItem <Boolean> True or False If an item is an Elder item or not.
ShaperItem <Boolean> True or False If an item is a Shaper item or not.
FracturedItem <Boolean> True or False If an item is fractured or not
SynthesisedItem <Boolean> True or False If an item is synthesised or not
ShapedMap <Boolean> True or False If the map is shaped or not.
MapTier [Operator] <Value> Numeric Tier (1-17) The map tier of the map.


Name Valid Values Notes
SetBorderColor <Red> <Green> <Blue> [Alpha] 0-255 Sets the border colour of the item box in RGB values from 0-255 with optional Alpha (opacity) value of 0-255
SetTextColor <Red> <Green> <Blue> [Alpha] 0-255 Sets the text colour of the item box in RGB values from 0-255 with optional Alpha (opacity) value of 0-255
SetBackgroundColor <Red> <Green> <Blue> [Alpha] 0-255 Sets the colour of the item box in RGB values from 0-255 with optional Alpha (opacity) value of 0-255
SetFontSize <FontSize> 18-45 (default: 32) Sets the font-size of item text. [2]
PlayAlertSound <Id> [Volume] 1-? [0-300] Plays the specified Alert Sound with optional volume when dropped. Only one sound can be played at a time.
PlayAlertSoundPositional <Id> [Volume] 1-? [0-300] Plays the specified Alert Sound with optional volume when dropped. Only one sound can be played at a time.
DisableDropSound Disable the drop sound (undocumented feature).
CustomAlertSound <FileName/FilePath> local path to the filter file OR absolute path Plays the specified custom sound when a specified item drops. (almost all of the common file extensions should be supported)
MinimapIcon <Size> <Color> <Shape>
  • Size: 0 (largest), 1 (medium), 2 (small)
  • Color: Red, Green, Blue, Brown, White, Yellow
  • Shape: Circle, Diamond, Hexagon, Square, Star, Triangle
Displays an icon on the minimap for specified items.
PlayEffect <Color> [Temp] Red, Green, Blue, Brown, White, Yellow Displays a coloured beam of light above an item highlighted by an item filter.

Use the Temp parameter to have a beam only appear as the item drops.
Otherwise, it will be permanently visible.

A list of the default RGB codes used in-game can be found in the corresponding item filter guide section.


Example 1

  • Shows all items with a red, green and blue linked socket
  • Changes the text color to a light blue one
    SocketGroup RGB
    SetTextColor 127 127 255

Example 2

  • Shows all items that match the following conditions
    • Item class is either Ring or Amulet
    • Item basename contains "Gold"
    • Item has the "Rare" rarity level
    • Item level is 75 or higher
  • Effectively, this means rare Gold Rings and Gold Amulets with item level 75 or higher will be shown
  • Changes the border to a yellow border
    Class Ring Amulet
    BaseType Gold
    Rarity Rare
    ItemLevel >= 75
    SetBorderColor 255 255 0

Known issues

Known issues with workaround. Use at your own risk.

Item filters not found

Solution A

  • Check that the filter has the correct ending (.filter )
  • Check whether the item filter is placed in the correct folder

Solution B

Currently (beta) item filters may not load for users who use a non-ASCII userpath. As a work around you can move your documents folder to a location which does not contain non-ASCII letters. To do so:

 Go to your user folder (%USERPROFILE%) -> right click on My Documents -> properties -> path -> move... -> select a new location to move to -> apply

List of item filters

Note: For sorting by multiple columns hold SHIFT.

General purpose filters

NameAuthorReleaseIngame FeaturesOther FeaturesFiltration Support
Ajido's Aesthetically Pleasing Loot FilterAjido (Twitch YouTube)2015-07-17majormajoryesyesyesyesyespartialyesyesyesno
Androox's FilterAndr00x2018-02-18partialmajoryesmajoryesyesyesmajoryesyesyesno
Antnee's Classy Item FilterAntnee2015-04-14minorminorminorminoryesyesyesyesyesyesyesyes
Ben's Loot Filterbenjaminbona2016-04-25majormajoryesmajoryesminoryesyesyesyesyesyes
EpicFail42's Loot FilterEpicFail422015-06-25minormajorpartialminorpartialmajoryesyesminornoyesno
Filter of TreasuresMaskedChimp2015-06-04minormajorminorpartialyesyesyesyesyesyesyesyes
goodcake's loot filtergoodcake2015-07-10partialyesnoyesnoyesyesyesyesnonono
Hellcat5's Not so Ugly Loot FilterHellcat52015-07-18majormajoryesmajoryesyesyesyesminoryesyesyes
Highwind's Lootfilterffhighwind2015-12-10majormajormajormajoryesyesyesyesyesyesyesyes
Ment's Item FilterMent20082015-04-11partialmajormajorminoryesyesyesyesyesyesnono
NeverSink's LootfilterNeverSink2015-04-15partialpartialmajormajoryesyesyesyesyesyesyesunknown
One Filter to rule them allMuldini2015-05-03minorminorminorminoryesyesyesyesyesyesyesyes
Sayya's Item FilterSayyadinaAtreides2015-05-05nopartialpartialminoryesyesyesyesyesyesyesunknown
Simplefilter - hide as invisibleKoszmarnica (koszmarnica01 and PathofExile)2019-08-04partialpartialyesyesyesyespartialpartialpartialnopartialno
StupidFatHobbit's SovereignStupidFatHobbit2016-03-02partialyesmajormajoryesyesyesyesyesyesnono
Yet Another Loot FilterFreeeeez at Forums and Wiki2015-07-13noyesyesminoryesyesyesmajormajorpartialnono
ZiggyD's Loot FilterZiggyD (Twitch YouTube)2015-04-22minorpartialyesminoryesmajoryesyesyesnonono

Specialized filters

Filters that are intended for a specialized purpose, such as leveling a specific class or otherwise.

NameAuthorReleaseIngame FeaturesOther FeaturesFiltration SupportDescription

Version history

Version Changes
  • In item filters, you can now use PlayAlertSoundPositional rather than PlayAlertSound to play a positional version (the sound comes from where the item dropped).
  • Item filters can now play a much larger array of sounds when items drop.
  • Items filters can now see whether an item is corrupted with "corrupted true".
  • There's now an item filter bundled with Path of Exile that you can select in the User Interface options.
  • Added "Identified" as a filter option for Item Filters. Valid values for this filter are "True" or "False".
  • Fixed a bug where Labyrinth Items could be displayed incorrectly when modifying how they are shown using Item Filters.
  • Sound events triggered by item filters can now have a maximum volume of 300 (up from 100).
  • Fixed a bug with Item Filters where some item types would not load if they were included in a type that was already loaded. For example, "Thrusting" when "Swords" was already loaded.
  • Introduced to the game.

See also


  1. (12 May 2015). "Item Filter Suggestions; Identified items, corrupted items, and grid sizes.". Reddit. Retrieved 12 May 2015.
  2. (02 May 2015). "PSA: You can change the font size in item filters.". Reddit. Retrieved 02 May 2015.