Skip to content

fingerprintjs/fingerprintjs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

909 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

FingerprintJS logo

Build status Current NPM version Monthly downloads from NPM Monthly downloads from jsDelivr

Discord server

FingerprintJS is an open-source, client-side, browser fingerprinting library that queries browser attributes and computes a hashed visitor identifier from them. Unlike cookies and local storage, a fingerprint stays the same in incognito/private mode and even when browser data is purged.

FingerprintJS is available under the MIT license.

Demo

Visit https://fingerprintjs.github.io/fingerprintjs to see your visitor identifier.

Now, try visiting the same page in private/incognito mode and notice that the visitor identifier remains the same!

Installation

npm

npm install @fingerprintjs/fingerprintjs
import FingerprintJS from '@fingerprintjs/fingerprintjs'

// Initialize the agent at application startup.
const fpPromise = FingerprintJS.load();

(async () => {
  // Get the visitor identifier when you need it.
  const fp = await fpPromise
  const result = await fp.get()
  console.log(result.visitorId)
})()

CDN

<script>
  // Initialize the agent at application startup.
  // If you're using an ad blocker or Brave/Firefox, this import will not work.
  // Please use the npm package instead: https://t.ly/ORyXk
  const fpPromise = import('https://openfpcdn.io/fingerprintjs/v5')
    .then(FingerprintJS => FingerprintJS.load());

  (async () => {
    // Get the visitor identifier when you need it.
    const fp = await fpPromise
    const result = await fp.get()
    console.log(result.visitorId)
  })()
</script>

Run this code

Resources

๐Ÿ“• API Reference

โš›๏ธ Sample usage with React on the StackBlitz platform

๐Ÿ”‘ FingerprintJS Licensing

Limitations

Accuracy

Since FingerprintJS processes and generates fingerprints in the browser itself, the accuracy is significantly lower than in the commercial version

Security

Because fingerprints are generated and processed in the browser, they are vulnerable to spoofing and reverse engineering.

Want higher accuracy? Upgrade to Fingerprint Identification for free

FingerprintJS is great for getting started, but if you need production-grade accuracy for web or mobile, consider Fingerprint Identification. You can sign up for a free account to get started.

Fingerprint Identification is a closed-source, commercial device intelligence platform designed to prevent fraud and improve user experiences. It's an enhanced version of FingerprintJS, fully redesigned to solve the most challenging identification use cases. Unlike FingerprintJS, it combines client-side signal collection with server-side processing. It collects over 100 browser and device signals, which are then analyzed server-side alongside network-level data, including signals that are entirely invisible to the browser, allowing it to reliably deduplicate visitors with identical devices. This server-side processing also validates that signals have not been tampered with or replayed, and generates a stable visitor identifier with industry-leading accuracy that is significantly harder to spoof than a purely client-side fingerprint.

Upgrading for free also unlocks access to the Fingerprint MCP Server, letting your AI coding assistant build and interact directly with Fingerprint. To access Smart Signals (device signals such as bot detection, VPN detection, and browser tampering detection), a 14-day free trial of the full platform is available.

Check out our comparison table for a detailed breakdown of the differences between FingerprintJS and Fingerprint Identification.

Fingerprint Identification resources

๐Ÿฟ Fingerprint Identification live demo

๐Ÿ“• Fingerprint Identification documentation

โ–ถ๏ธ Video: Use Fingerprint Identification to prevent multiple signups by the same user

โฑ๏ธ How to upgrade from FingerprintJS to Fingerprint Identification in 30 seconds

Migrating to v5

Migrating from Migration Guide Documentation
v4 Migrating from v4 to v5 v4 documentation
v3 Migrating from v3 to v5 v3 documentation

Version policy

See the compatibility policy for the API and visitor identifiers in the version policy guide.

Supported browsers

The library supports all popular browsers. See more details and learn how to run the library in old browsers in the browser support guide.

Where to get support

Using Issues and Discussions publicly will help the community and other users with similar issues.

You can also join our Discord server to ask questions, share feedback, and connect with other developers.

If you require private support for FingerprintJS, please email us at [email protected].

Contributing

See the Contribution guidelines to learn how to contribute to the project or run the project locally. Please read it carefully before making a pull request.