Skip To Content


Available with Image Server

The Fill tool fills sinks and peaks in a surface raster to remove small imperfections in the data.

The output is a hosted imagery layer.

Usage notes

Fill includes configurations for input layers, analysis settings, and result layer.

Input layer

The Input layer group includes the following parameter:

  • The Input surface raster is the elevation raster that will be used for calculation.

    A sink is a cell with an undefined drainage direction where no adjacent cells are lower. A peak is a cell where no adjacent cells are higher. To remove peaks, the Input surface raster must be inverted. This can be done with the Minus tool. Specify the highest value of the surface raster as the first input to the Minus tool and the surface raster as the second input. Then use the Fill tool. Invert the results to obtain a surface that has original surface raster values with the peaks removed.

Fill setting

The Fill setting group includes the following parameter:

  • The Z-limit parameter specifies the maximum elevation difference to be filled between the depth of a sink and its pour point.

    The Z-limit is not the maximum depth to which a sink will be filled.

    Unless a value is specified for this parameter, all sinks will be filled regardless of depth.

    The value for the Z-limit parameter must be greater than zero.

    If the difference in z-values between a sink and its pour point is greater than the specified Z-limit, that sink will not be filled.

    The Z-limit can be applied when filling peaks as well. If no Z-limit value is specified, all peaks will be removed. If a Z-limit value is specified and the difference in z-values between a peak and its highest adjacent neighbor is greater than the Z-limit value, that peak will not be removed.

Result layer

The Result layer group includes the following parameters:

  • Output raster name is the name of the output raster layer that will be created and added to the map.

    The name must be unique. If a layer with the same name already exists in your organization, the tool will fail and you will be prompted to use a different name.

  • Save in folder specifies the name of a folder in My content where the result will be saved.


Analysis environment settings are additional parameters that affect a tool's results. You can access the tool's analysis environment settings from the Environment settings parameter group.

This tool honors the following analysis environments:


The Output raster name parameter stores the surface raster after sinks have been filled.

Usage requirements

This tool requires the following licensing and configurations:

  • Creator or GIS Professional user type
  • Publisher, Facilitator, or Administrator role, or an equivalent custom role
  • ArcGIS Image Server configured for raster analysis


Use the following resources to learn more:

  • Fill in ArcGIS REST API
  • fill in ArcGIS API for Python
  • Fill in ArcGIS Pro with the Raster Analysis extension
  • Fill in ArcGIS Pro with the Spatial Analyst extension