Integrations
Kalima currently supports four practical client entry points.
Integration matrix
| Path | Best for | Key inputs | Notes |
|---|---|---|---|
| Script Tag | Marketing sites, server-rendered apps, CMS pages | Project key, optional runtime config | Fastest install; ideal when you want Kalima to handle runtime language delivery |
| Public API / SDK API | Headless apps, custom frontends, controlled render pipelines | Project key, API base URL, app-side rendering logic | Best when your app already owns translation rendering |
| WordPress plugin | WordPress-managed websites | Project key, API base URL, locale settings | Plugin injects the SDK and supports query/path URL modes |
| Shopify app + theme embed | Shopify storefronts | Project key, API base URL, SDK script URL, locale settings | Storefront-specific locale detection and theme embed controls |
Script Tag
Current hosted SDK artifact used across the repo:
<script
src="https://uni-sdk.kalima.digital/kalima.js"
data-project-key="your-project-key"
></script>
Use the Script Tag path if:
- You want a fast install with minimal code changes
- You are localizing pages that already render text in the DOM
- You want built-in features such as language switching and CSS masking
Continue with JavaScript SDK.
Public API / SDK API
Current production base URL:
https://sdk-api.kalima.digital/api/v1
Use the API path if:
- You want to fetch approved translations and apply them yourself
- You need phrase extraction from your own runtime or tooling
- You want instant translation requests for controlled use cases
Continue with API reference.
WordPress
The WordPress plugin defaults to:
- API base URL:
https://api.kalima.digital/api/v1 - Dashboard URL:
https://app.kalima.digital - SDK URL: bundled plugin asset, with optional override
WordPress setup highlights:
- Configure the project key under
Settings -> Kalima - Set default language and supported locales
- Choose query parameter or path-based locale mode
- Optional hreflang tags and language switcher are supported
- SDK URL overrides must use an allowed HTTPS host unless you are on localhost
Shopify
The Shopify app and theme embed default to:
- API base URL:
https://sdk-api.kalima.digital/api/v1 - SDK script URL:
https://uni-sdk.kalima.digital/kalima.js - Default language:
en - Locale mode:
query - Language param:
lang
Shopify setup highlights:
- Save storefront settings in the Kalima Shopify app
- Sync those settings into the theme embed
- Use Shopify locale detection if you want storefront locale fallback
- Enable hreflang tags, masking, or language switcher per storefront need
How to choose
Choose Script Tag or WordPress when speed matters most. Choose the public API when your app already owns rendering. Choose Shopify when your storefront team needs a guided app + embed workflow.
Support
Need help shipping this integration?
If you hit a blocker, contact Kalima with your project key, target environment, and a short description of what failed.