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 a federated ArcGIS Server site

Note:

If ArcGIS Enterprise on Kubernetes is configured with web-tier authentication, the PrintingTools service and custom print services will not be able to print any of your site's services.

Default print service

By default, Portal for ArcGIS 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.

PrintingTools service

PrintingTools is a preconfigured service 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, and SVGZ, TIFF, and AIX.

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—ArcGIS Pro layout files (.pagx).

Note:

Custom print services are not supported in ArcGIS Enterprise on Kubernetes at 10.9. If you have federated a Windows or Linux server with your organization, you can configure its custom print service with the organization by following these steps.

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 or Map Viewer Classic. 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.