Website integration

WikiHere hover cards

Install one script. Normal links to public PoE2 WikiHere entity pages then show the same compact item facts used inside the wiki.

01

Add a normal link and the script

Keep the real WikiHere URL in the HTML. The link still works, remains indexable, and provides the backlink when JavaScript is unavailable.

<a href="https://poe2.wikihere.com/currency/chaos-orb">Chaos Orb</a>
<script async src="https://poe2.wikihere.com/embed/v1/hover-card.js"></script>

Working example

Point at the link, focus it with the keyboard, or tap it on a phone.
Chaos Orb

02

JSON endpoint

Version 1 returns the canonical URL, image, classification, properties, requirements, summary, modifier groups, flavour text, game version, and dataset identity.

https://poe2.wikihere.com/api/embed/v1/preview?url=https%3A%2F%2Fpoe2.wikihere.com%2Fcurrency%2Fchaos-orb

Behavior and controls

Mouse
The card opens on hover and closes when the pointer leaves.
Keyboard
Focusing the link opens the card. Escape closes it.
Touch
The first tap opens the card. Tapping the same link again follows it.
Exclude a link
Add data-wikihere-preview="off" to that anchor.
Disable touch mode
Add data-touch="off" to the script element.

Content Security Policy

Allow https://poe2.wikihere.com in these directives:

  • script-src for the versioned loader
  • connect-src for preview JSON
  • style-src for the card stylesheet
  • img-src for locally cached entity images

Cache and request limits

Successful responses are cacheable for one hour and may be served stale while WikiHere refreshes them. The endpoint accepts 180 uncached requests per client in a one-minute window. The loader caches each preview for the lifetime of the page.