Skip to main content Skip to complementary content

Background layers

Background layers enable you to display a custom base map for your map visualization.

A background layer could, for example, be a map of an airport that then has a point layer with WIFI hotspot locations overlaid on it. If the custom base map format supports transparency, you can overlay it on top of another map. Qlik Sense supports the following custom maps formats as background layers:

  • Slippy or tile map services (TMS)
  • Web Map Service (WMS)
  • Image URL (Image)

Maps services must be located on their own server. Unlike other layers, the background layer uses no dimensions or measures and only displays an external base map.

If your WMS contains areas with no data, you can set the areas with no data to be transparent. This enables the WMS background layer to be overlaid on another base map or background layer. You can also choose which WMS layers to include in the background layer.

You can insert an image as a background layer. This can be used as a custom base map. You could add an image of a floor plan and use it as a custom base map. An image background layer can also be overlaid on top of another background layer. For example, you could insert an image of a detailed local map as a background layer over top another map. Background layers support the following image types:

  • .png
  • .jpg
  • .jpeg
  • .gif

Map with background layer displaying a TMS OpenStreetMap map.

Map with background layer.

Adding a background layer

Background layer configuration varies depending on the type of background map.

Adding a TMS background layer

  1. From Layers in the properties panel, click Add layer.
  2. Select Background layer.
  3. After Format, select TMS.
  4. After URL, enter the URL to a tile or slippy map server.

    For example, http://a.tile.opencyclemap.org/cycle/${z}/${x}/${y}.png.

  5. After Attribution, enter the attribution string for the map.

    For example, &copy; <a href='http://www.opencyclemap.org/' target='_blank'>OpenCycleMap</a>. Map data &copy; <a href='http://www.openstreetmap.org/copyright' target='_blank'>OpenStreetMap</a> contributors.

Once the layer is added, you can adjust settings for the layer in the properties panel. For more information on settings, see Map properties.

Adding a WMS background layer

  1. From Layers in the properties panel, click Add layer.
  2. Select Background layer.
  3. Under Format, select WMS.
  4. Click WMS setup.
  5. Under WMS server URL, enter the URL.
  6. Under Version, select the WMS version.
  7. Click Load WMS.

  8. After CRS, enter the coordinate reference system used by the WMS map.

  9. Select Transparent to generate map images that are transparent where there is not data.

    Information note

    This is not supported by all WMS.

  10. Under Image format, select the WMS image format.
  11. Under Layers, select the map layers that your WMS server supports.
  12. Click Save.
  13. After Attribution, enter the attribution string for the map.

    For example, &copy; <a href='http://www.opencyclemap.org/' target='_blank'>OpenCycleMap</a>. Map data &copy; <a href='http://www.openstreetmap.org/copyright' target='_blank'>OpenStreetMap</a> contributors.

Once the layer is added, you can adjust settings for the layer in the properties panel. For more information on settings, see Map properties.

Adding an image background layer

Images can be used as a custom base map, such as for floor plans. When using an image background layer as a custom base map, set Base map in Map settings to None. Select Undefined meters or Undefined degrees as the projection. The location data for your other layers must use same coordinate system as this background layer.

Tip note

When you add an image background layer for a smaller geographic area as a custom base map, add a layer containing data, such as a point layer, at the same time. This lets the map automatically zoom in to the position of your image background layer.

Tip note

The lowest unit in the scale bar is 10 meters. If this measurement is too large for your image, you can disable the scale bar in Presentation and then proportionally adjust up your image in the background layer to the scale you want. Scale the location data you want to use in other layers as well.

  1. From Layers in the properties panel, click Add layer.
  2. Select Background layer.
  3. Under Format, select Image.
  4. After URL, enter the URL of the image.
  5. Position your image by entering the coordinates for the top left and bottom right corners of the image.

    Coordinates must be in the same coordinate type as was selected in Projection.

    Tip note

    If you are unsure of the coordinates in your image background layer, enable Show debug info. This will display the coordinates for the current center of your map.

  6. After Attribution, enter the attribution string for the image.

    For example, &copy; <a href='http://www.opencyclemap.org/' target='_blank'>OpenCycleMap</a>. Map data &copy; <a href='http://www.openstreetmap.org/copyright' target='_blank'>OpenStreetMap</a> contributors.

Once the layer is added, you can adjust settings for the layer in the properties panel. For image background layers being used as custom base maps, it is recommended that you change the Limit zoom levels and Limit pan navigation settings to set the focus on your custom map. For more information on settings, see Map properties.

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – let us know how we can improve!