16.1. Raster Properties Dialog¶
To view and set the properties for a raster layer, double click on the layer name in the map legend, or right click on the layer name and choose Properties from the context menu. This will open the Raster Layer Properties dialog.
There are several tabs in the dialog:
External plugins tabs
 Also available in the Layer styling panel
 External plugins you install can optionally add tabs to this dialog. Those are not presented in this document. Refer to their documentation.
Live update rendering
The Layer Styling Panel provides you with some of the common features of the Layer properties dialog and is a good modeless widget that you can use to speed up the configuration of the layer styles and view your changes on the map canvas.
Because properties (symbology, label, actions, default values, forms…) of embedded layers (see Nesting Projects) are pulled from the original project file, and to avoid changes that may break this behavior, the layer properties dialog is made unavailable for these layers.
general such as name in the project, source path, list of auxiliary files, last save time and size, the used provider
based on the provider of the layer: extent, width and height, data type, GDAL driver, bands statistics
the Coordinate Reference System: name, units, method, accuracy, reference (i.e. whether it’s static or dynamic)
read from layer properties: data type, extent, width/height, compression, pixel size, statistics on bands, number of columns, rows and no-data values of the raster…
picked from the filled metadata: access, extents, links, contacts, history…
the Layer name to display in the Layers Panel;
the Coordinate Reference System: Displays the layer’s Coordinate Reference System (CRS). You can change the layer’s CRS, by selecting a recently used one in the drop-down list or clicking on the Select CRS button (see Coordinate Reference System Selector). Use this process only if the layer CRS is a wrong or not specified. If you wish to reproject your data, use a reprojection algorithm from Processing or Save it as new dataset.
The raster layer symbology tab is made of three different sections:
The Band rendering where you can control the renderer type to use
The Layer rendering to apply effects on rendered data
The Resampling methods to optimize rendering on map
QGIS offers many different Render types. The choice of renderer depends on the data type and the information you’d like to highlight.
Multiband color - if the file comes with several bands (e.g. a satellite image with several bands).
Paletted/Unique values - for single band files that come with an indexed palette (e.g. a digital topographic map) or for general use of palettes for rendering raster layers.
Singleband gray - (one band of) the image will be rendered as gray. QGIS will choose this renderer if the file is neither multiband nor paletted (e.g. a shaded relief map).
Singleband pseudocolor - this renderer can be used for files with a continuous palette or color map (e.g. an elevation map).
Hillshade - Creates hillshade from a band.
Contours - Generates contours on the fly for a source raster band.
With the multiband color renderer, three selected bands from the image will be used as the red, green or blue component of the color image. QGIS automatically fetches Min and Max values for each band of the raster and scales the coloring accordingly. You can control the value ranges in the Min/Max Value Settings section.
A Contrast enhancement method can be applied to the values: ‘No enhancement’, ‘Stretch to MinMax’, ‘Stretch and clip to MinMax’ and ‘Clip to min max’.
When adding GRASS rasters, the option Contrast enhancement will always be set automatically to stretch to min max, even if this is set to another value in the QGIS general options.
Viewing a Single Band of a Multiband Raster
If you want to view a single band of a multiband image (for example, Red), you might think you would set the Green and Blue bands to Not Set. But the preferred way of doing this is to set the image type to Singleband gray, and then select Red as the Gray band to use.
This is the standard render option for singleband files that include a color table, where a certain color is assigned to each pixel value. In that case, the palette is rendered automatically.
It can be used for all kinds of raster bands, assigning a color to each unique raster value.
If you want to change a color, just double-click on the color and the Select color dialog appears.
It is also possible to assign labels to the colors. The label will then appear in the legend of the raster layer.
Right-clicking over selected rows in the color table shows a contextual menu to:
Change Color… for the selection
Change Opacity… for the selection
Change Label… for the selection
The pulldown menu, that opens when clicking the … (Advanced options) button below the color map to the right, offers color map loading (Load Color Map from File…) and exporting (Export Color Map to File…), and loading of classes (Load Classes from Layer).
This renderer allows you to render a layer using only one band with a Color gradient: ‘Black to white’ or ‘White to black’. You can change the range of values to color (Min and Max) in the Min/Max Value Settings.
A Contrast enhancement method can be applied to the values: ‘No enhancement’, ‘Stretch to MinMax’, ‘Stretch and clip to MinMax’ and ‘Clip to min max’.
Pixels are assigned a color based on the selected color gradient and the layer’s legend (in the Layers panel and the layout legend item) is displayed using a continuous color ramp. Press Legend settings… if you wish to tweak the settings. More details at Customize raster legend.
This is a render option for single-band files that include a continuous palette. You can also create color maps for a band of a multiband raster.
Pixels are assigned a color based on the selected color ramp and the layer’s legend (in the Layers panel and the layout legend item) is displayed using a continuous color ramp. Press Legend settings… if you wish to tweak the settings or instead use a legend with separated classes (and colors). More details at Customize raster legend.
Render a band of the raster layer using hillshading.
Band: The raster band to use.
Altitude: The elevation angle of the light source (default is
Azimuth: The azimuth of the light source (default is
Z Factor: Scaling factor for the values of the raster band (default is
This renderer draws contour lines that are calculated on the fly from the source raster band.
Input band: the raster band to use.
Contour interval: the distance between two consecutive contour lines
Contour symbol: the symbol to apply to the common contour lines.
Index contour interval: the distance between two consecutive index contours, that is the lines shown in a distinctive manner for ease of identification, being commonly printed more heavily than other contour lines and generally labeled with a value along its course.
Index contour symbol: the symbol to apply to the index contour lines
Input downscaling: Indicates by how much the renderer will scale down the request to the data provider (default is
For example, if you generate contour lines on input raster block with the same size as the output raster block, the generated lines would contain too much detail. This detail can be reduced by the “downscale” factor, requesting lower resolution of the source raster. For a raster block 1000x500 with downscale 10, the renderer will request raster 100x50 from provider. Higher downscale makes contour lines more simplified (at the expense of losing some detail).
By default, QGIS reports the Min and Max values of the band(s) of the raster. A few very low and/or high values can have a negative impact on the rendering of the raster. The Min/Max Value Settings frame helps you control the rendering.
Available options are:
Mean +/- standard deviation x: Creates a color table that only considers values within the standard deviation or within multiple standard deviations. This is useful when you have one or two cells with abnormally high values in a raster layer that impact the rendering of the raster negatively.
Calculations of the min and max values of the bands are made based on the:
Statistics extent: it can be Whole raster, Current canvas or Updated canvas. Updated canvas means that min/max values used for the rendering will change with the canvas extent (dynamic stretching).
Accuracy, which can be either Estimate (faster) or Actual (slower).
For some settings, you may need to press the Apply button of the layer properties dialog in order to display the actual min and max values in the widgets.
This method can be used to classify and represent scalar dataset (raster or mesh contour) based on their values. Given a color ramp and a number of classes, it generates intermediate color map entries for class limits. Each color is mapped with a value interpolated from a range of values and according to a classification mode. The scalar dataset elements are then assigned their color based on their class.
A Min and Max values must be defined and used to interpolate classes bounds. By default QGIS detects them from the dataset but they can be modified.
The Interpolation entry defines how scalar elements are assigned their color :
<=symbol appears in the header of the Value column): The color is taken from the closest color mapl entry with equa or higher value
Linear: The color is linearly interpolated from the color map entries above and below the pixel value, meaning that to each dataset value corresponds a unique color
=symbol appears in the header of the Value column): Only pixels with value equal to a color map entry are applied a color; others are not rendered.
The Color ramp widget helps you select the color ramp to assign to the dataset. As usual with this widget, you can create a new one and edit or save the currently selected one. The name of the color ramp will be saved in the configuration.
The Label unit suffix adds a label after the value in the legend, and the Label precision controls the number of decimals to display.
The classification Mode helps you define how values are distributed across the classes:
Equal interval: Provided the Number of classes, limits values are defined so that the classes all have the same magnitude.
Continuous: Classes number and color are fetched from the color ramp stops; limits values are set following stops distribution in the color ramp.
Quantile: Provided the Number of classes, limits values are defined so that the classes have the same number of elements. Not available with mesh layers.
You can then Classify or tweak the classes:
Double clicking in the Value lets you modify the class value.
Double clicking in the Color column opens the dialog Change color, where you can select a color to apply for that value.
Double clicking in the Label column to modify the label of the class, but this value won’t be displayed when you use the identify feature tool.
Right-clicking over selected rows in the color table shows a contextual menu to Change Color… and Change Opacity… for the selection.
With linear Interpolation, you can also configure:
Clip out of range values: By default, the linear method assigns the first class (respectively the last class) color to values in the dataset that are lower than the set Min (respectively greater than the set Max) value. Check this setting if you do not want to render those values.
When applying a color ramp to a raster or a mesh layer, you may want to display a legend showing the classification. By default, QGIS displays a continuous color ramp with min and max values in the Layers panel and the layout legend item. This can be customized using the Legend settings button in the classification widget.
In this dialog, you can set whether to Use continuous legend: if unchecked, the legend displays separated colors corresponding to the different classes applied. This option is not available for raster singleband gray symbology.
Checking the Use continuous legend allows you to configure both the labels and layout properties of the legend.
Add a Prefix and a Suffix to the labels
Modify the Minimum and a Maximum values to show in the legend
Customize the Number format
Customize the Text format to use in the print layout legend.
Control the Orientation of the legend color ramp; it can be Vertical or Horizontal
Control the Direction of the values depending on the orientation:
If vertical, you can display the Maximum on top or the Minimum on top
If horizontal, you can display the Maximum on right or the Minimum on right
Over the symbology type applied to the layer band(s), you can achieve special rendering effects for the whole raster file(s):
Use one of the blending modes (see Blending Modes)
Set custom Brightness, Saturation, Gamma and Contrast to colors.
Turn the layer to Grayscale option either ‘By lightness’, ‘By luminosity’ or ‘By average’.
Colorize and adjust the Strength of Hue in the color table
Press Reset to remove any custom changes to the layer rendering.
The Resampling option has effect when you zoom in and out of an image. Resampling modes can optimize the appearance of the map. They calculate a new gray value matrix through a geometric transformation.
When applying the ‘Nearest neighbour’ method, the map can get a pixelated structure when zooming in. This appearance can be improved by using the ‘Bilinear’ or ‘Cubic’ method, which cause sharp edges to be blurred. The effect is a smoother image. This method can be applied to for instance digital topographic raster maps.
Use the Global opacity slider to set to what extent the underlying layers (if any) should be visible through the current raster layer. This is very useful if you overlay raster layers (e.g., a shaded relief map overlayed by a classified raster map). This will make the look of the map more three dimensional. The opacity of the raster can be data-defined, and vary e.g. depending on the visibility of another layer, by temporal variables, on different pages of an atlas, …
With No data value QGIS reports the original source no data value (if defined) which you can consider as is in the rendering. Additionally, you can enter a raster value that should be treated as an Additional no data value. The Display no data as color selector allows you to apply a custom color to no data pixels, instead of the default transparent rendering.
An even more flexible way to customize the transparency is available in the Custom transparency options section:
Use Transparency band to apply transparency for an entire band.
Provide a list of pixels to make transparent with corresponding levels of transparency:
Enter the Red, Green and Blue values of the pixel and adjust the Percent Transparent to apply.
Repeat the steps to adjust more values with custom transparency.
Press the Apply button and have a look at the map.
As you can see, it is quite easy to set custom transparency, but it can be quite a lot of work. Therefore, you can use the button Export to file to save your transparency list to a file. The button Import from file loads your transparency settings and applies them to the current raster layer.
The Histogram tab allows you to view the distribution of the values in your raster. The histogram is generated when you press the Compute Histogram button. All existing bands will be displayed together. You can save the histogram as an image with the button.
At the bottom of the histogram, you can select a raster band in the drop-down menu and Set min/max style for it. The Prefs/Actions drop-down menu gives you advanced options to customize the histogram:
The Min/max options allow you to ‘Always show min/max markers’, to ‘Zoom to min/max’ and to ‘Update style to min/max’.
The Actions option allows you to ‘Reset’ or ‘Recompute histogram’ after you have changed the min or max values of the band(s).
set Scale dependent visibility for the layer: You can set the Maximum (inclusive) and Minimum (exclusive) scale, defining a range of scales in which the layer will be visible. It will be hidden outside this range. The Set to current canvas scale button helps you use the current map canvas scale as a boundary. See Scale Dependent Rendering for more information.
Refresh layer at interval (seconds): set a timer to automatically refresh individual layers. Canvas updates are deferred in order to avoid refreshing multiple times if more than one layer has an auto update interval set.
High resolution raster layers can slow navigation in QGIS. By creating lower resolution copies of the data (pyramids), performance can be considerably improved, as QGIS selects the most suitable resolution to use depending on the zoom level.
You must have write access in the directory where the original data is stored to build pyramids.
From the Resolutions list, select resolutions at which you want to create pyramid levels by clicking on them.
If you choose Internal (if possible) from the Overview format drop-down menu, QGIS tries to build pyramids internally.
Please note that building pyramids may alter the original data file, and once created they cannot be removed. If you wish to preserve a ‘non-pyramided’ version of your raster, make a backup copy prior to pyramid building.
If you choose External and External (Erdas Imagine) the
pyramids will be created in a file next to the original raster with
the same name and a
Several Resampling methods can be used for pyramid calculation:
Finally, click Build Pyramids to start the process.
The Metadata tab provides you with options to create and edit a metadata report on your layer. See Metadata for more information.
Depending on the symbology applied to the layer, you may end up with several entries in the legend, not necessarily readable/useful to display. The Legend placeholder image helps you select an image for replacement, displayed both in the Layers panel and the print layout legend.
The Embedded widgets in Legend provides you with a list of widgets you can embed within the layer tree in the Layers panel. The idea is to have a way to quickly access some actions that are often used with the layer (setup transparency, filtering, selection, style or other stuff…).
By default, QGIS provides a transparency widget but this can be extended by plugins that register their own widgets and assign custom actions to layers they manage.