The Print widget allows you to print web maps and includes options for previewing extents, selecting layouts, and more.
Use this widget to support app design requirements such as the following:
- You want surveyors to print maps of underground utility features.
- You want search and rescue teams to quickly print maps for a missing person search operation.
- You want to allow members of the public to easily print maps containing city data.
When you include this widget in an app, the widget provides users with the following tools:
- Template—Select a print template.
- Preview print extent—Add a rectangle to the map showing the print extent.
- Print—Create a print result.
- Print result—View print results. Click a result to open it in a new window.
When you include this widget in an app in Classic mode, the widget provides users with the standard tools and any additional settings you've chosen to make editable. You can make settings such as the map title and print quality editable under Template common settings and in the Template configuration panel.
When you include this widget in an app in Compact mode, the widget only provides users with the standard tools. Advanced print settings cannot be customized at run time.
The Print widget includes the following settings:
Source—Select a map widget with 2D data.
Mode—Choose a style for the widget, either Classic or Compact. The Classic mode gives users more control over advanced template and layout options. If you choose the Compact mode, users can only use the template and layout options you configure. For example, Classic is appropriate if you want users to choose any scale for the printed map, while Compact is best if you want to provide a set, unchangeable map scale.
Configure print template—Add a print service and configure templates.
Select utility—Select a printing utility service. You can use print services specified in your organization settings or added by you in the Select utility or Utility service panels. The following is an example of a print service URL:
Use dark colors for code blocks Copy
Once you select a print service, the service automatically adds print templates. You can add, reorder, and delete the templates. The template you list first is the default template at runtime.
Template configuration—Add a new template or change settings for a template from the print service.
Map-only options (Available for templates that use the map-only layout)—Set the default map size in pixels and choose whether printed maps include the attribution by default. When Classic mode is selected, you can make the map size and attribution editable at runtime under Select editable settings.
Layout options (Available for all layouts except map-only)—Set the default author, copyright, and scale bar unit and choose whether printed maps include the legend by default.
Override common settings—Enable this to stop using template common settings for a template.
Template common settings—Common settings apply to all templates unless you choose to override them in each individual template's Template configuration panel. In Classic mode, you can set defaults and select editable settings. In Compact mode, you can set defaults and users can only use the settings and values you provide.
Title—Specify the printed file name, and the map title when applicable.
Map printing extents—Choose how to calculate the map's printed extent.
- Current map extent—Use the Map widget's current view.
- Current map scale—Use the Map widget's current scale.
- Set map scale—Provide an exact scale.
Output spatial reference—Define the output spatial reference of the print by specifying a valid well-known ID (WKID).
Print quality—Set the print resolution.
Feature attributes—Check this setting to include feature attributes in feature collection layers.