Mailing Label Widget Overview
This widget is designed to enhance mailing label management within the ArcGIS Experience Builder ecosystem. It offers seamless integration with map layers, advanced selection and drawing tools, and supports multiple label output formats including CSV and PDF.
Note: Requires install of jsPDF on client folder, running npm install jspdf
Note: Input service needs to be a Feature Layer (editing capabilities not required)
Developer Edition Configuration
End User Interaction
What Can This Widget Do?
Original capabilities (from core logic):
Select and configure map layers to use as data sources for labels.
Map fields to specific mailing fields (name, address, city, state, zip).
Draw shapes (point, polyline, polygon, rectangle, circle) to select areas for labels.
Generate labels in CSV and PDF formats with customizable label templates (Avery 5160–5164).
Font size options for printed labels.
Automatically disables Esri’s popups and highlights while active to focus on drawing and selection.
Clear selection areas and restore map behavior when the widget is closed.
Enhanced capabilities in this version:
Dynamic field mapping options that populate from selected layers.
Buffering options (distance and unit) for drawn geometries to expand selection areas.
Clear selection graphics and highlight management with fallback visualizations for feature selection.
Responsive label previews and customizable font size and label formats.
Error handling and messaging for failed queries or drawing operations.
Map view and layer management to handle disconnected or delayed map loading gracefully.
Interactive user messages (success, warning, error) displayed for actions like selection, generation, or errors.
Configuration Options
Map Widget Selection: Choose the map widget to connect to.
Layer and Field Mapping: Select a feature layer and assign fields to mailing label fields.
Geometry Selection: Enable selection by click, draw, or both; configure a buffer for drawn areas.
Label Format and Font: Choose from multiple Avery formats and set the font size.
Output Options: Generate mailing labels as CSV or open a print-ready PDF.
Changelog:
08/01/2025: Enhanced address type management and UI adaptation
- Added dual address type support: Widget now supports both Physical Mailing Address and Owner Address configurations with separate field mappings and optional separate data layers
- Added conditional UI display: Radio button selection automatically hides when only one address type is enabled in settings, providing a cleaner single-purpose interface
- Added automatic selection clearing: When switching between address types, any existing selections are automatically cleared to prevent data confusion, with user notification
07/23/2025: Tested widget on Developer Edition 1.18 that was released on 7/23/25 and widget functions as normal.
06/12/2025: Resolved bug that allowed for selection of up to 2,000 records but downloaded only 500. Limit now is 2,000 for both selection and CSV/PDF download.
05/28/2025: Automatic PDF Downloads with Smart Naming
Improvements and Enhancements for User Group
These are potential areas of improvement and ideas that could be explored in future updates, and are open to feedback and suggestions from the Esri Community:
