Appearance
URL parameters and sizing Finland
The embed URL sets the language, the design and the first-load access token. This page is the reference for that contract and for sizing the iframe. Examples use the test hosts; see Environments for demo and production.
URL parameters
| Part | Required | Example | Notes |
|---|---|---|---|
| Base URL | yes | …/embedded.html or …/embedded-horizontal.html | The host selects the environment; the page selects your navigation |
lang | no | fi, en, sv | Overrides the company's default language |
skin | no | mycompany | The name of your design, without .css. Lower-case letters, digits, - and _ only; any other value is ignored. Without skin, the design set in the company's service model is used |
#access_token | yes, on the first load | a JWT | Always in the hash |
Embed hosts: test https://test-embed.palkkaus.fi/, demo https://demo-embed.palkkaus.fi/, production https://embed.palkkaus.fi/ — see Environments.
Languages: Finnish (fi, the default), English (en) and Swedish (sv).
Why the token is in the hash
The payroll UI is a single-page application:
- anything before
#is a full reload, - anything after
#is navigation.
If the part before the hash changes, the SPA restarts, the session is lost and a new access token is needed. After the first load, never change anything before #.
Sizing the iframe
The recommended height:
css
height: calc(100vh - 200px);It leaves room for your own header and footer. If your layout changes dynamically, adjust the height with JavaScript when it changes. The payroll UI does not report its content height to your page, so size the iframe to the space you give it, not to its content.

