Skip To Content

Raster and imagery default options

The raster and imagery default options allow you to change settings, which will be applied to all of your imagery and raster datasets. You can access these options from Project tab > Options > Raster and Imagery.

The raster and imagery options consist of the following six categories:

  • Appearance
  • Cache
  • Raster Dataset
  • Mosaic Dataset
  • Perspective Imagery
  • Raster Formats


The Appearance options allow you to set rendering defaults for rasters that you add to a view.

Check the Use band wavelength information when available check box to allow ArcGIS Pro to determine which bands will be used to display multispectral data as RGB. Due to technological advances, more sensors are incorporating additional bands of information. If you consistently work with a sensor that is not one of the raster products, it may make sense to uncheck this check box and alter the Three band data and Multispectral data defaults.

You can select a default color scheme from the Color Scheme drop-down menu, which will be used to display single band data when first added to a view. The default color scheme for a single band raster added to a view is black to white for the stretched renderer or a random color scheme for the unique values renderer. If you want to go back to the system defaults, click the Reset button.

The Set default RGB composition section allows you to manually set the bands used as the red, green, and blue composite. The band composition can be set differently for Three band data and Multispectral data. You can type the band number in the box, or you can use the up and down arrows to adjust the band number. If a raster product is added to a view, ArcGIS Pro will override these defaults if the Use band wavelength information when available check box is checked.

You can use the Enable custom rendering defaults option to set a specific way to display all of your datasets. This is turned off by default because users tend to work with many different kinds of data, from high-resolution imagery to classified raster datasets. It makes sense to enable this if you work with a specific type of dataset.

The background of a raster dataset can be displayed in a specific color or with transparency. This allows you to hide or highlight the background. To display the background value in a specific color, check the Display background value check box, and specify the background value and the color. Usually, the background color is set to transparent so that it is hidden.

The NoData color allows you to hide or highlight these values. Typically, the NoData color is set to transparent so that the NoData values are hidden.


When checked, if an image service has cache generated, it will display the image service cache rather than the image service.

Raster Dataset

The Build pyramid settings expander allows you to set the Build pyramid dialog settings, Resampling method, Compression method, and Compression quality.


Build pyramid dialog settings

Allows you to choose how to handle raster datasets that do not have pyramids built:

  • Always prompt for pyramids—Display a dialog prompt to ask if the pyramids should be built.
  • Always build pyramids—Always build pyramids before adding the raster dataset to the display. This may take some time.
  • Never build pyramids—Never build pyramids when adding a raster dataset to the display.

Resampling method

Choose the resampling method used when building pyramids:

  • Nearest Neighbor—This method uses the value of the closest cell to assign a value to the output cell when resampling.
  • Bilinear—This method determines the new value of a cell based on a weighted distance average of the four nearest input cell centers.
  • Cubic—This method determines the new value of a cell based on fitting a smooth curve through the 16 nearest input cell centers.

Compression method

The compression type to use when building the raster pyramids:

  • Default—If the source data is compressed using a wavelet compression, it will build pyramids with the JPEG compression type; otherwise, LZ77 will be used.
  • LZ77—The LZ77 compression algorithm will be used to build the pyramids. LZ77 can be used for any data type.
  • JPEG—The JPEG compression algorithm to build pyramids. Only data that adheres to the JPEG compression specification can use this compression type. If JPEG is chosen, you can then set the Compression Quality.
  • JPEG YCbCr—A lossy compression using the luma (Y) and chroma (Cb and Cr) color space components. You can then set the Compression Quality of the pyramid output.
  • None—No compression will be used when building pyramids.

Compression quality

The compression quality to use when pyramids are built with the JPEG or JPEG YCbCr compression method. The value must be between 0 and 100. The values closer to 100 will produce a higher-quality image, but the compression ratio will be lower.

Check Use the world file to define the coordinates of the raster if you want to override the dataset's native georeferencing with the world file information.

The Maximum number of values to display option is set to 65,536 by default. This is the maximum number of values you can get with 16-bit data. Increasing this number will enable you to work with datasets that have a greater bit depth without scaling it down to 16 bit; however, this will increase computational effort and lower performance.

The Proxy files location allows you to work around restrictions that system administrators put on data repositories. For example, if you need to build pyramids for an image but only have read permissions to that folder, the pyramids will be built in the proxy location.

Mosaic Dataset

These options allow you to control how a mosaic dataset is presented in the Contents pane.

  • Expand the mosaic dataset—Display its component layers, boundary, footprint, and image in the Contents pane.
  • Show the boundary on the map—Display the full extent of the dataset as a polygon on the map.
  • Show the footprint on the map—Show the extent of each raster within the mosaic dataset on the map.
  • Show the seamlines on the map—Use the Build Seamlines tool to create a smoother looking mosaic dataset when working with images collected at varying times and spatial resolutions. They will be shown as feature classes on the map.
  • Show the image on the map—Uncheck this check box to improve performance if it is not necessary to immediately see your imagery or raster dataset.

Perspective Imagery

Perspective imagery is usually oblique imagery collected at angles offset from vertical. Perspective imagery can be displayed in image analysis mode, based on the image's coordinate system—columns and rows—rather than a map coordinate system. You can check the Set focus on the first operational perspective image layer to map check box to automatically work in the perspective view when an appropriate layer is added to a map.

Raster Formats

This section shows you a table of the raster and imagery formats you can work with in ArcGIS Pro.


Enabling and disabling specific formats is not currently supported. All formats are enabled.

Related topics