Skip to content

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 ​

PartRequiredExampleNotes
Base URLyes…/embedded.html or …/embedded-horizontal.htmlThe host selects the environment; the page selects your navigation
langnofi, en, svOverrides the company's default language
skinnomycompanyThe 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_tokenyes, on the first loada JWTAlways 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.

Every page is also available as Markdown: add .md to its URL — a folder page such as white-label/ is white-label/index.md. Index for LLMs: llms.txt. Questions: Support.