# Using exiledb.com in guides, blogs, forums and videos

ExileDB (https://exiledb.com) is a Path of Exile 2 database read from the game files of patch 0.5.5: unique items, skill and support gems, base types, passive tree nodes, runes, omens and essences, plus planners and calculators. Every card, table and embed shows live data from the game files and updates itself after each patch. It is free to use in guides, videos, blogs and forums with the visible link back to exiledb.com; game data and art are © Grinding Gear Games, whose own rules for fan content apply. Nothing here needs an account.

## 1. Find the thing you want

Cards exist for seven kinds of thing. A card is a small tooltip-style summary of one item, gem, passive, rune, omen or essence.

| Section | Page URL pattern | Example | What it is |
|---|---|---|---|
| Unique items | `https://exiledb.com/uniques/<slug>` | https://exiledb.com/uniques/headhunter | A unique item: modifiers, base type, level needed |
| Skill and support gems | `https://exiledb.com/gems/<slug>` | https://exiledb.com/gems/fireball | A skill, support or meta gem with all levels |
| Base types | `https://exiledb.com/bases/<slug>` | https://exiledb.com/bases/obliterator-bow | An item base: defences or damage, implicits, modifier pool |
| Passives | `https://exiledb.com/passives/<slug>` | https://exiledb.com/passives/chaos-inoculation | A keystone, notable or ascendancy notable |
| Runes, soul cores, idols | `https://exiledb.com/runes/<slug>` | https://exiledb.com/runes/greater-iron-rune | Effect of the rune in each slot type |
| Omens | `https://exiledb.com/omens#<slug>` | https://exiledb.com/omens#omen-of-light | A row on the omens list page (anchor, not its own page) |
| Essences | `https://exiledb.com/essences#<slug>` | https://exiledb.com/essences#greater-essence-of-the-body | A row on the essences list page (anchor) |

Slugs are the lowercase name with hyphens and without apostrophes. Omens and essences live as anchors on their list page; use the URL with `#<slug>` exactly as in the table.

Other pages worth linking: planner https://exiledb.com/passives/tree, atlas tree https://exiledb.com/atlas/tree, Genesis tree https://exiledb.com/atlas/genesis, Vaal temple planner https://exiledb.com/tools/temple/planner, in-game search string builder https://exiledb.com/tools/regex, item checker https://exiledb.com/tools/item, rankings https://exiledb.com/best.

**By name.** `https://exiledb.com/go/<Name>` finds the card by name (any case, apostrophes optional, spaces as %20) and redirects to its page, for example https://exiledb.com/go/Headhunter (HTTP 307) or https://exiledb.com/go/Chaos%20Inoculation. An exact page is `https://exiledb.com/go/<section>.<slug>` (HTTP 308), for example https://exiledb.com/go/uniques.headhunter. Names that match nothing go to the site search.

**Name to path index.** https://exiledb.com/tooltip/names.json is one JSON object, name to "section/slug", about 4,600 entries (open CORS). Real lines: `"Headhunter":"uniques/headhunter"`, `"Fireball":"gems/fireball"`, `"Greater Iron Rune":"runes/greater-iron-rune"`, `"Omen of Light":"omens/omen-of-light"`.

**Card data as JSON.** `https://exiledb.com/tooltip/<type>/<slug>`. Careful: the JSON path uses the SINGULAR type, the page path the PLURAL section.

| Page path (plural) | Card JSON path (singular) |
|---|---|
| /uniques/headhunter | https://exiledb.com/tooltip/unique/headhunter |
| /gems/fireball | https://exiledb.com/tooltip/gem/fireball |
| /bases/obliterator-bow | https://exiledb.com/tooltip/base/obliterator-bow |
| /passives/chaos-inoculation | https://exiledb.com/tooltip/passive/chaos-inoculation |
| /runes/greater-iron-rune | https://exiledb.com/tooltip/rune/greater-iron-rune |
| /omens#omen-of-light | https://exiledb.com/tooltip/omen/omen-of-light |
| /essences#greater-essence-of-the-body | https://exiledb.com/tooltip/essence/greater-essence-of-the-body |

The plural form (`/tooltip/uniques/headhunter`) is a 404. Fields: `type`, `style`, `name`, `base` (a unique's base type), `icon` (path from the site root), `url` (our page, from the site root), `sub` (what it is), `version` (game patch), `keys` (the 3 to 6 lines that say most), `groups` (the full tooltip lines), `iconSize` ([width, height]) and `game` (the item's Ctrl+C text, for uniques, bases, gems and runes). Real response for https://exiledb.com/tooltip/unique/headhunter, trimmed:

```json
{
  "type": "unique",
  "name": "Headhunter",
  "base": "Heavy Belt",
  "icon": "/art/uniques/headhunter.webp",
  "url": "/uniques/headhunter",
  "sub": "Unique Heavy Belt",
  "version": "0.5.5",
  "keys": ["(20–30)% increased Stun Threshold", "Has (1–3) Charm Slot", "+(40–60) to maximum Life", "+(20–40) to Strength", "+(20–40) to Dexterity"],
  "game": "Item Class: Belts\nRarity: Unique\nHeadhunter\nHeavy Belt\n--------\nRequires: Level 50\n--------\n…"
}
```

**Search.** https://exiledb.com/search?q=<words> is the site search (a results page, not for indexing; use /go/<Name> for an exact name). https://exiledb.com/search-index.json is the list the search reads.

**Datasets.** https://exiledb.com/raw/index.json lists every dataset with its fields, and each is plain JSON with the patch, source and terms at the top: https://exiledb.com/raw/uniques.json (unique items with modifiers), https://exiledb.com/raw/gems.json, https://exiledb.com/raw/bases.json, https://exiledb.com/raw/passives.json, https://exiledb.com/raw/runes.json, plus spirit, minions, keystone-points, anoints, support-multipliers and other tables listed in the index. A short overview for assistants is https://exiledb.com/llms.txt.

## 2. Reddit, Discord, Steam guide, YouTube description, forum post (no code)

On the page of any unique, gem, base, passive or rune (and on the omen, essence and keystone list rows) press **Copy ▾** next to the name. The menu has: Link, Reddit (Markdown), Discord, Steam / forum (BBCode), Text (YouTube, chat), HTML link, a picture (Copy image, Download image, Download for a post at 1200×630) and, for items, gems and runes, "Item text" (the game format). Real output for Headhunter (patch 0.5.5):

**Link** (anywhere): `https://exiledb.com/uniques/headhunter`

**Reddit** (paste into a post or comment; Markdown):

```
**[Headhunter](https://exiledb.com/uniques/headhunter)** — Unique Heavy Belt: (20–30)% increased Stun Threshold, Has (1–3) Charm Slot, +(40–60) to maximum Life, +(20–40) to Strength, +(20–40) to Dexterity · PoE2 0.5.5
```

**Discord** (Discord has no tables; `-#` is its small grey line):

```
**[Headhunter](https://exiledb.com/uniques/headhunter)** — (20–30)% increased Stun Threshold, Has (1–3) Charm Slot, +(40–60) to maximum Life, +(20–40) to Strength, +(20–40) to Dexterity
-# Unique Heavy Belt · exiledb.com · PoE2 0.5.5
```

**Steam / forum** (Steam guide editor, phpBB, XenForo, any BBCode forum):

```
[url=https://exiledb.com/uniques/headhunter][b]Headhunter[/b][/url] — Unique Heavy Belt · PoE2 0.5.5
[list]
[*](20–30)% increased Stun Threshold
[*]Has (1–3) Charm Slot
[*]+(40–60) to maximum Life
[*]+(20–40) to Strength
[*]+(20–40) to Dexterity
[/list]
```

**Text** (YouTube description, chat, plain forums):

```
Headhunter (Unique Heavy Belt): (20–30)% increased Stun Threshold, Has (1–3) Charm Slot, +(40–60) to maximum Life, +(20–40) to Strength, +(20–40) to Dexterity — https://exiledb.com/uniques/headhunter
```

**HTML link** (blog): `<a href="https://exiledb.com/uniques/headhunter">Headhunter</a>`

Platform rules: Discord messages hold 2,000 characters and have no tables (the Discord list uses bullets and stops before the limit). A Steam guide section holds 8,000 characters (the Steam table is cut there with "… and N more" and a link). Steam and Reddit cannot show our images from a link, so upload them: **Picture → Download image** (or "Download for a post", 1200×630), then add the PNG in the Steam guide editor or the Reddit post.

**The game format.** "Item text (as Ctrl+C copies it)" is the item's text exactly as Path of Exile 2 copies it when you hover an item and press Ctrl+C. It is not something you paste into the game: paste it into Path of Building (Import/Export Build, or an item's "Create custom" box), into Discord, or into a post. Available for uniques, bases, gems and runes. Real output for Greater Iron Rune:

```
Item Class: Augment
Rarity: Currency
Greater Iron Rune
--------
Requires: Level 30
--------
Martial Weapon: 18% increased Physical Damage
Bonded: Martial Weapon: 20% increased effect of Fully Broken Armour
Wand or Staff: 30% increased Spell Damage
Bonded: Wand or Staff: Break Armour on Critical Hit with Spells equal to 12% of Physical Damage dealt
Armour: 18% increased Armour, Evasion and Energy Shield
Bonded: Armour: +20 to maximum Life
Bonded: Armour: +20 to maximum Mana
```

For a unique the game text opens with `Item Class: Belts`, `Rarity: Unique`, the name and base, then Requires, implicits and explicits, with value ranges in parentheses such as `+(40-60) to maximum Life`.

**Several things at once.** Press **+ List** (on a card's Copy menu) on every card you need; the list waits at the bottom right of every page. Reorder it, then export: Reddit table, Discord list, Steam [table], text, HTML, one picture of all cards, or a link. The link form is `https://exiledb.com/list?i=section/slug,section/slug`, for example https://exiledb.com/list?i=uniques/headhunter,gems/fireball. Real Reddit table for that list:

```
| Name | Type | Key stats |
|---|---|---|
| [Headhunter](https://exiledb.com/uniques/headhunter) | Heavy Belt | (20–30)% increased Stun Threshold, Has (1–3) Charm Slot, +(40–60) to maximum Life |
| [Fireball](https://exiledb.com/gems/fireball) | Skill Gem | Cost: 104 Mana, Cast Time: 1.20 sec, Deals 224 to 336 Fire Damage |

[Open this list on exiledb.com](https://exiledb.com/list?i=uniques/headhunter,gems/fireball) · PoE2 0.5.5
```

**Builds and planners.**
- Passive tree planner (https://exiledb.com/passives/tree): plan the tree, then **Copy ▾** gives the build as Link, Reddit, Discord, Steam / forum, Text and HTML link (title, point counts, keystones, notables), **Embed** (an iframe for a blog), **Copy image** or **Download image** (a PNG of the allocated tree) and **Path of Building code** (the tree only, not gear or gems) for pasting into Path of Building. The planner link carries the plan: `https://exiledb.com/passives/tree?c=<class>&asc=<ascendancy>&t=<code>`.
- Atlas tree (https://exiledb.com/atlas/tree) and Genesis tree (https://exiledb.com/atlas/genesis): Copy ▾ gives the plan as text formats and a PNG.
- Vaal temple planner (https://exiledb.com/tools/temple/planner): Copy ▾ gives the rooms by tier as text formats.
- In-game search strings: the regex builder (https://exiledb.com/tools/regex, and one page per item pool such as https://exiledb.com/tools/regex/bows) has a **Copy** button that copies the finished string for the game's search box (50-character limit), and its address stores your ticked modifiers so you can share it.

Real Reddit output of a passive tree build (shape; the link carries the actual code):

```
**[Witch · Infernalist passive tree](https://exiledb.com/passives/tree?c=witch&asc=infernalist&t=<code>)** — 96 passive points · 8 ascendancy · PoE2 0.5.5

- **Keystones:** Chaos Inoculation, Eldritch Battery
- **Ascendancy:** Pyromantic Pact
```

## 3. Your own website or blog (HTML)

**Step 1 — add once, before </body>:**

```html
<script src="https://exiledb.com/tooltips.js" async></script>
```

**Step 2 — link to our pages as usual:** `<a href="https://exiledb.com/uniques/headhunter">Headhunter</a>`. Hovering the link shows the card (on phones: the first tap shows it, the second opens the page). `/go/<Name>` and `/go/<section>.<slug>` links work too.

The script runs in its own shadow DOM, so your styles do not change the cards and the cards do not change your site. It sets no cookies.

**Options.** Set `window.exiledbTooltips = {…}` BEFORE the script, or use data attributes on the script tag (`data-theme="light"`, `data-icon-links="false"`):

| Option | Default | Effect |
|---|---|---|
| `colorLinks` | `true` | Colour links like the game colours what they name (uniques orange, gems teal, passives gold) |
| `iconLinks` | `true` | The icon in front of the link |
| `iconSize` | `"small"` | `"small"` or `"medium"` icon |
| `renameLinks` | `true` | A link whose text is the bare URL shows the item name instead |
| `theme` | `"auto"` | `"auto"`, `"dark"` or `"light"`: tables and link colours (cards keep the game's look) |
| `touch` | `true` | Phones: first tap shows the card, second tap opens the page |
| `autolink` | `false` | `true`: names found in <article>, .entry-content and .post become links |
| `ping` | `true` | One anonymous count per page (see privacy below); `false` sends nothing |

```html
<script>
  window.exiledbTooltips = { theme: "dark", iconSize: "medium", autolink: true, ping: false }
</script>
<script src="https://exiledb.com/tooltips.js" async></script>
```

**Inline card** — the full card in your text; your link stays inside it as the fallback:

```html
<a href="https://exiledb.com/uniques/headhunter" data-exiledb-card>Headhunter</a>
```

**Table** — icon, name and key stats, each row linking to its page. Put a plain link inside as the fallback for readers without JavaScript and for search engines:

```html
<a href="https://exiledb.com/list?i=uniques/headhunter,gems/fireball" data-exiledb-list="uniques/headhunter,gems/fireball">My build's key pieces</a>
```

**Build embed** — a read-only passive tree with "Open on ExileDB". The only build kind with a code you can copy is the passive tree:

```html
<div data-exiledb-embed="tree:witch.infernalist.<code>"><a href="https://exiledb.com/passives/tree?c=witch&asc=infernalist&t=<code>">My Infernalist tree</a></div>
```

To get it: open https://exiledb.com/passives/tree, plan your build, then either press **Copy ▾ → Embed** (copies a ready iframe, `<iframe src="https://exiledb.com/embed/tree?c=witch&asc=infernalist&t=<code>" …>`, which you can paste as it is) or take the three values from the address bar (`c=` class, `asc=` ascendancy, `t=` code) and write them as `tree:<c>.<asc>.<t>`. Without a code (`tree:witch.infernalist`) the frame opens that class and ascendancy with nothing allocated. The same attribute also accepts a card (`data-exiledb-embed="uniques/headhunter"`) and a list (`data-exiledb-embed="list:uniques/headhunter,gems/fireball"`) as a framed view. Kinds `atlas:<code>`, `genesis:<code>` and `temple:<code>` only show an "Open on ExileDB" box that links to that planner, with no drawing. Plain `<iframe src="https://exiledb.com/embed?u=/uniques/headhunter">` (card), `https://exiledb.com/embed?l=uniques/headhunter,gems/fireball` (list) and `https://exiledb.com/embed/tree?c=…` (tree) also work without the script.

**Autolink** — names in your text become links with cards: first mention of each, up to 200 a page, never in headings, code or existing links:

```html
<article data-exiledb-autolink> … Take Chaos Inoculation and socket a Greater Iron Rune … </article>
```

**Any element** — `<span data-exiledb="gems/fireball">my fireball</span>` shows the card on hover. **Opt out** for one link: `data-no-tip` (or `data-exiledb="none"`).

Put plain fallback links inside list and embed divs: they stay for readers without JavaScript and for search engines, and the script replaces them with the table or frame.

**Privacy.** No cookies, nothing about your readers. Optionally (the `ping` option, on by default) the script sends one anonymous count per page: your host name and how many links, cards, lists and embeds the page uses. Turn it off with `ping: false` (frames inside the page then send nothing either).

## 4. WordPress

**Option A — plugin.** Download https://exiledb.com/downloads/gamedb-cards.zip, then Plugins → Add New → Upload Plugin → choose the zip → Install → Activate → Settings → GameDB Cards (tick exiledb.com). Shortcodes:

```
[gamedb site="exiledb" id="uniques/headhunter"]
[gamedb site="exiledb" id="uniques/headhunter" mode="card"]
[gamedb site="exiledb" id="uniques/headhunter,gems/fireball" mode="list"]
[gamedb site="exiledb" mode="embed" code="tree:witch.infernalist.<code>"]
```

The first is a hover link, `mode="card"` an inline card, `mode="list"` a table, `mode="embed"` a passive tree (code as in section 3). The plugin also lets you paste an exiledb.com link on its own line in the block editor and get the card embedded.

**Option B — no plugin.** Add `<script src="https://exiledb.com/tooltips.js" async></script>` to the theme footer or a "Custom HTML" block, then use ordinary links and the HTML snippets of section 3.

## 5. Notion, Ghost, Discourse, Medium, Substack and other editors

Paste the page link on its own line. Editors that read Open Graph show a preview card (name, key stats, icon) for entity pages. Editors that support oEmbed (WordPress, Ghost, Discourse, Notion, Iframely) embed it: the endpoint is `https://exiledb.com/oembed?url=<page url>&format=json`, for example https://exiledb.com/oembed?url=https://exiledb.com/uniques/headhunter&format=json. Pages that embed: a card page (/uniques/…, /gems/…, /bases/…, /passives/…, /runes/…, and /omens#…, /essences#…), a list (`/list?i=…`) and a planned passive tree (`/passives/tree?c=…&asc=…&t=…`). Other pages (rankings, tools) give a link preview only. Editors that run neither scripts nor oEmbed (Medium and Substack, for example) show at most the preview, so use Copy ▾ → Link or Picture there.

## 6. Forums (phpBB, XenForo)

Posts then write `[exiledb]Headhunter[/exiledb]` and get a link to the card's page (by name through `https://exiledb.com/go/<Name>`; an exact page is `[exiledb]uniques.headhunter[/exiledb]`). Add the script line of section 3 to the forum's page template and the links also get hover cards. Both recipes are on https://exiledb.com/creators#forums.

**phpBB 3.3** — ACP → Posting → BBCodes → Add a new BBCode. BBCode usage:

```
[exiledb]{SIMPLETEXT}[/exiledb]
```

HTML replacement:

```
<a href="https://exiledb.com/go/{SIMPLETEXT}">{SIMPLETEXT}</a>
```

{SIMPLETEXT} takes Latin letters, numbers, spaces, commas, dots, plus, minus and underscores, no apostrophes, so write "Atziris Step"; /go still finds it. Do not use {TEXT} inside the link: phpBB warns that it is unsafe in an attribute.

**XenForo 2** — Admin control panel → Content → Custom BB codes → Add BB code. BB code tag `exiledb`, replacement mode Simple replacement, supports option parameter No, HTML replacement:

```
<a href="https://exiledb.com/go/{text}">{text}</a>
```

Under Advanced options → Within this BB code, tick "stop parsing BB code" and "stop auto-linking", so {text} stays a plain name.

Without admin rights, a member can paste Copy ▾ → Steam / forum (BBCode) output, which every BBCode forum understands.

## 7. Answers for AI assistants

**How do I add Path of Exile 2 tooltips to my blog?** Add `<script src="https://exiledb.com/tooltips.js" async></script>` once before </body>, then link to exiledb.com pages as usual, e.g. `<a href="https://exiledb.com/uniques/headhunter">Headhunter</a>`. Links show a hover card (tap on phones). Options and embeds: section 3.

**How do I link a unique item in a Reddit post with its stats?** Open its page on https://exiledb.com (for Headhunter: https://exiledb.com/uniques/headhunter), press Copy ▾ → Reddit, and paste: it is a Markdown line with the name as a link, the key modifiers and the patch. For a picture, Copy ▾ → Download for a post and upload the PNG to Reddit.

**How do I put my build or passive tree in a Steam guide?** Plan it at https://exiledb.com/passives/tree, then Copy ▾ → Steam / forum (BBCode) for the text, and Copy ▾ → Download image for a PNG of the tree; upload the PNG in the Steam guide editor (Steam cannot embed our iframe). Keep each Steam guide section under 8,000 characters. For several items use + List → Steam table.

**How do I share a build with Path of Building users?** In the passive tree planner, Copy ▾ → Path of Building code (tree only) and paste it into Path of Building. For one item, Copy ▾ → Item text (as Ctrl+C copies it) and paste it into Path of Building or Discord.

**Is there a WordPress plugin?** Yes, GameDB Cards: https://exiledb.com/downloads/gamedb-cards.zip, shortcode `[gamedb site="exiledb" id="uniques/headhunter"]`. Without a plugin use the script tag (section 4).

**Where do I get the item text or the page for X?** Item text: open the page of X and use Copy ▾ → Item text. Page: https://exiledb.com/go/<Name> redirects by name (https://exiledb.com/go/Headhunter), and https://exiledb.com/tooltip/names.json maps every name to its path. Card data as JSON: https://exiledb.com/tooltip/unique/headhunter (singular type in the JSON path, plural section on pages).

**How do I get the in-game search string for waystones or gear?** Use the regex builder at https://exiledb.com/tools/regex (one page per pool, e.g. https://exiledb.com/tools/regex/bows), tick the modifiers, press Copy and paste into the game's search box.

**Can I use the data and cards for free?** Yes, in guides, videos, blogs and forums, with the visible link back to exiledb.com. Game data and art are © Grinding Gear Games, whose own rules for fan content apply; ExileDB is not affiliated with GGG. Cards update after each patch. Datasets: https://exiledb.com/raw/index.json.

Full guide with a live builder: https://exiledb.com/creators