Last modified: Mar 26, 2026

Map

🚧 This documentation is a work in progress.

Usage

Anatomy

Properties

We are currently updating how we implement components, and the list of properties may not be entirely accurate.
PropertyTypeDescription
idstringThe component ID. Must be unique within all layouts/pages in a layout-set. Cannot end with dash or number.
dataModelBindings.simpleBindingstringData model binding for a component’s connection to a single field in the data model.
textResourceBindings.titlestringThe title/label text for the component.
textResourceBindings.descriptionstringThe description text for the component (optional).
textResourceBindings.helpstringThe help text for the component (optional).
textResourceBindings.shortNamestringThe short name for the component, used in validation messages (optional). If it is not specified, ’title’ text is used.
textResourceBindings.tableTitlestringThe text shown in column title when component is used in repeating group (optional). If it is not specified, ’title’ text is used.
requiredbooleanBoolean or expression indicating if the component is required when filling in the form. Defaults to false.
readOnlybooleanBoolean or expression indicating if the component should be presented as read only. Defaults to false. Please note that even with read-only fields in components, it may currently be possible to update the field by modifying the request sent to the API or through a direct API call.
gridobjectSettings for the components grid. Used for controlling horizontal alignment.
Example(s): {xs: 12}
grid.innerGridgridPropsOptional. Grid for inner component content like input field or dropdown. Used to avoid inner content filling the component width.
Example(s): {xs: 12}
See: gridProps
grid.labelGridgridPropsOptional. Grid for the component label. Used in combination with innerGrid to align labels on the side.
Example(s): {xs: 12}
See: gridProps
hiddenbooleanBoolean value or expression indicating if the component should be hidden. Defaults to false.
pageBreakobjectEnables page break settings in PDF output.
pageBreak.breakAfterstringPDF only: Indicates whether a page break should be added after the component.
Allowed values: auto (default), always, avoid.
pageBreak.breakBeforestringPDF only: Indicates whether a page break should be added before the component.
Allowed values: auto (default), always, avoid.
renderAsSummarybooleanBoolean or expression indicating if the component should be rendered as a summary. Defaults to false.
centerLocationobjectCenter location of the map.
centerLocation.latitudenumberNumber or expression for the latitude of the center location.
centerLocation.longitudenumberNumber or expression for the longitude of the center location.
layersarrayList of map layers.
layers.attributionstringString for setting the attribution of the tile layer.
layers.subdomainsarrayList of subdomains. Used for balancing the load on different map tiling servers. A random one will replace {s} in the defined URL.
layers.urlstringThe URL to a map tile. {z}/{x}/{y} will be replaced with tile coordinates, {s} will be replaced with a random subdomain if subdomains are given.
zoomnumberNumber that sets the default zoom of the map.

Configuration

We are currently updating Altinn Studio Designer with more configuration options! The documentation is continuously updated, and there may be more settings available than what is described here, and some settings may be in beta version.

Add component

    You can add a component in Altinn Studio Designer by dragging it from the list of components to the page area. Selecting the component brings up its configuration panel.

    Basic component:

    App/ui/layouts/{page}.json
    {
      "$schema": "https://altinncdn.no/toolkits/altinn-app-frontend/4/schemas/json/layout/layout.schema.v1.json",
      {
        "data": {
          "layout": [
            {
              // Basic component (required properties)
            }
          ]
        }
      }
    }
    

    Examples