Quick Start
Get your widget running in under 5 minutes with a single script tag or npm install.
Get Your API Key
Sign up for JigsawStack and generate a public key to authenticate the widget.
Configuration Options
Customize language detection, positioning, font scaling, and widget visibility.
Programmatic API
Use
window.translate(), window.resetTranslation(), and window.clearCache() to control translations from your code.Choose your integration
Script tag (HTML)
Drop in two script tags and initialize. Works on any static or server-rendered site.
React / Next.js
Import the package and initialize inside a
useEffect hook.Next.js App Router
Client component integration for Next.js 13+ with the App Router.
Next.js Pages Router
Script component integration for Next.js 12 and below using
_app.tsx.Key features
100+ languages
Translate to and from over 100 languages with a single configuration option.
Smart caching
Translations are cached in localStorage so repeat visits load instantly.
Auto language detection
Automatically detect the user’s browser language and translate on load.
URL-based switching
Append
?lang=fr to any URL to load the page in a specific language.Fully customizable UI
Override CSS classes or use the built-in theme options to match your brand.
Programmatic control
Build custom language selectors using the
window.translate() API.The widget requires a public key from your JigsawStack dashboard. Make sure translation capabilities are enabled on your key.