Skip To Content

Configure the organization to print maps

You can configure ArcGIS Enterprise to generate printable documents from web maps and apps; this is done with print services. There are varying levels of functionality and customization available depending on the print service configured with your ArcGIS Enterprise organization. Print service options include the following:

  • The ArcGIS Enterprise default print service
  • The PrintingTools service from an ArcGIS Server site
  • A custom print service

The portal comes with a default print service as described below. You can configure your stand-alone portal or federated portal and server site to use the PrintingTools service from an ArcGIS Server instance. If you federate your portal and server site and configure a hosting server, the hosting server's print service is automatically started and configured with the portal. However, if you've previously configured a print service with your portal, the URL is not updated when specifying a hosting server. You must start the service, share the service, and configure it as a utility service.

Legacy:

In 10.3, if you specified a hosting server for your portal, the service was automatically configured with the portal, but you were required to start the service and share it. Beginning at 10.3.1, you only need to share the service.

Additional configuration is necessary when you use an ArcGIS Server print service with services that members add to the portal through HTTPS. You must configure any machine that runs the print service to trust Certificate Authority (CA) signed certificates from the site providing the HTTPS services. This configuration must take place at the operating system level. See Configure ArcGIS Server with a new CA-signed certificate for details on how to do this.

The organization's default print service

By default, ArcGIS Enterprise comes with a print service. Web apps created with a template or in ArcGIS Web AppBuilder will use the organization's print service in their print widgets.

The PrintingTools service

PrintingTools is a preconfigured service in the Utilities folder of an ArcGIS Server site that creates a printable document using one of a set of predefined map layouts. These include basic designs using 8.5 by 11 inch, 11 by 17 inch, A3, and A4 paper sizes in both portrait and landscape orientations. Each layout contains a north arrow, scale bar and ratio, legend, date, and title. The supported output formats from the PrintingTools service are PDF, PNG32, PNG8, JPG, GIF, EPS, SVG, SVGZ, TIFF, and AIX.

The PrintingTools service is stopped by default. Use ArcGIS Server Manager or an administrative GIS Server connection in ArcMap to start the service if you want to support printing workflows. Once the PrintingTools service has started, you can access it using a URL with the following format:

https://webadaptorhost.domain.com/webadaptorname/rest/services/Utilities/PrintingTools/GPServer/Export%20Web%20Map%20Task

To configure PrintingTools for your ArcGIS Enterprise organization, see Configure utility services.

Custom print services

If you want to use your map layouts, you can publish your own service for web map printing similar to PrintingTools. Configure this service to reference your folder that you've prepared with various map layouts—either ArcMap documents (.mxd) or ArcGIS Pro layout files (.pagx).

You can find instructions for publishing your own service for web printing (and pointing it at your own layouts folder) in Publish a print service from ArcMap and in Share custom layouts for printing from ArcGIS Pro. The tutorial also explains what to do if you later decide you want to update your layouts. Your update approach will vary based on whether you registered your layouts folder with the server before publishing; the tutorial contains instructions for both scenarios.

Next, configure the custom print service with your ArcGIS Enterprise organization. See Configure utility services for steps on how to do this. Note that ArcGIS Enterprise requires the custom print service to use HTTPS.

Use print services in apps

After you configure a PrintingTools service or a custom print service for the organization, the service is used automatically in several apps. For example, in the Web AppBuilder print widget, the web app templates that contain print widgets use the configured service automatically, and the Map Viewer Print button generates a MAP_ONLY view of the web map. To print using the predefined layouts that come with PrintingTools or your custom layouts, share the web map in an app from Web AppBuilder or a web app template with printing functionality enabled. You can print from the Basic Viewer, Classic Viewer, and Map Tools web app templates.

Note:

When your map service is cached, the PrintingTools service may use a resolution that is too low (for example, 96 DPI) for large-format or high-quality printing. To print at higher resolutions, enable dynamic layers on your cached map service. This allows the print service to obtain map images through an export map request at the desired resolution (for example, 300 DPI) instead of the lower resolution tiles. To learn more, see Dynamic layers.

Create print templates in Map Viewer

You can provide custom templates for printing from Map Viewer. Templates are based on what's provided in the organization's print service.

Add a print service according to the steps provided in Configure utility services. After ArcGIS Enterprise validates the REST URL you provide, you'll see all the initial layout templates provided by your print service. You'll also see the option to print the legend if it is available. If your ArcGIS Enterprise organization has more than one print layout available, the Map Viewer Print button includes a drop-down list of the different print layouts. You can create, edit, or delete templates to have a more customized experience for printing maps in Map Viewer. These changes are saved as a setting in ArcGIS Enterprise; they are not saved to the print service.

You can manage the layout templates in the following ways:

  • To create a layout, click Create Print Template and type a name up to 50 characters in length and a description up to 120 characters in length. The characters < and > are filtered out. Choose the format—Image (PNG32) or PDF—and a layout (provided by your print service). Check the box to print the legend if your service includes a legend. Click Create and Save to save the new layout.
  • To view information about a template, click the information button Information next to the template.
  • To edit an existing template, click the edit button Edit next to the template and make your updates. Click Update to see your changes and click Save to save your changes.
  • To delete an existing template, click the Delete button Delete next to the template.
  • To update the template list to include what's currently provided in your print service, click Refresh. New print layouts in the service are added to the template list. Templates based on print layouts that are no longer available in the service are removed.
  • To reset the templates back to what's provided in your print service, remove the print service URL, click Save, and type the print service URL again.
  • If you want the default Map Viewer print experience, delete all your layout templates and click Save. You see Map Only in your template list.
  • The Map Only layout comes with all print services by default. This layout contains only the contents of the map with no other layout elements.

Legends

Whether your ArcGIS Enterprise organization is configured to use PrintingTools or a custom print service, the legends in your printed output behave similarly. When you print feature services or map services (those published from ArcGIS Pro to ArcGIS Server 10.7.1 and later), the legend in the printed document only includes legend entries for the features found in the map extent, whereas legends for other service types include all the legend entries for the features regardless of the map extent.

Note:

Legends for stream layers, WMS, layers with transparency, and layers that use smart mapping may not display correctly.