This topic describes the attribution you are required to display in applications that use Esri technology.
Example of Esri and data attribution in a mapping application
Types of attribution
There are two types of attribution that apply to building applications with Esri technology:
Esri attribution: The requirement to display Powered by Esri text when using ArcGIS APIs, SDKs, services, or data.
Data attribution: The requirement to display all data source provider names in maps that use ArcGIS basemap and/or data services.
Learn more about the types of attribution and the display requirements below.
Esri attribution
Esri attributionEsri attribution is the requirement to display "Powered by Esri" text in all applications that use Esri technology including ArcGIS Maps SDKs, APIs, content, or services.Learn more is the requirement to display Powered by Esri text in all applications that use Esri technology. This includes applications that use any ArcGIS API, SDK, serviceA service, also known as an ArcGIS service, is software that supports an ArcGIS REST API and provides geospatial functionality or data. A service can be hosted by Esri or in ArcGIS Enterprise.Learn more, contentContent is a collection of items in a portal that belong to a user, group, or organization.Learn more, or data. The attribution is required for applications that either contain a map or do not contain a map. If you can not meet the Esri attribution requirements for any reason, please contact Esri.
You need to include Esri attribution if your application uses:
An open source or third-party library with an ArcGIS serviceA service, also known as an ArcGIS service, is software that supports an ArcGIS REST API and provides geospatial functionality or data. A service can be hosted by Esri or in ArcGIS Enterprise.Learn more, contentContent is a collection of items in a portal that belong to a user, group, or organization.Learn more, or data.
ArcGIS servicesA service, also known as an ArcGIS service, is software that supports an ArcGIS REST API and provides geospatial functionality or data. A service can be hosted by Esri or in ArcGIS Enterprise.Learn more, contentContent is a collection of items in a portal that belong to a user, group, or organization.Learn more, or data directly or indirectly with a REST API.
ArcGIS servicesA service, also known as an ArcGIS service, is software that supports an ArcGIS REST API and provides geospatial functionality or data. A service can be hosted by Esri or in ArcGIS Enterprise.Learn more, contentContent is a collection of items in a portal that belong to a user, group, or organization.Learn more, or data but do not display a map.
Display requirements
The Powered by Esritext must be clearly displayed in your application.
Requirements
The text must be clearly displayed on the map, application, or in a window that is accessible from a menu or button.
The text must not be covered or obstructed by other UI elements.
The text must be easily discoverable.
Recommendations
Position text at the bottom-right of the main application.
Include text with the data attribution.
Include text in all UI components that use Esri technology.
Font family: "Avenir Next W00","Helvetica Neue", Helvetica,Arial,sans-serif;
Font color: #323232 (100% opacity)
Background color: #ffffff (65% opacity)
Font size: 12px or larger.
Examples with a map
The following are acceptable examples of displaying Esri attributionEsri attribution is the requirement to display "Powered by Esri" text in all applications that use Esri technology including ArcGIS Maps SDKs, APIs, content, or services.Learn more in applications that contain a map:
Default
Joined
In a control
In a pop-up
Examples without a map
The following are acceptable examples of displaying Esri attributionEsri attribution is the requirement to display "Powered by Esri" text in all applications that use Esri technology including ArcGIS Maps SDKs, APIs, content, or services.Learn more in applications that do not contain a map:
In a control
In the app
From a menu
From a button
Data attribution
Data attributionData attribution is the requirement to display the names of data source providers in all applications when accessing ArcGIS content, layers, or services.Learn more is the requirement to display the names of all data source providers for the data used in a map. This includes the data source providers for any ArcGIS content, data, or service such as ArcGIS Location Services, ArcGIS Enterprise services, and hosted data services. This also includes data source providers listed in content itemsAn item, also known as a content item, is a resource stored in a portal such as a web map, hosted layer, style, script tool, file, or notebook.Learn more such as hosted layersA hosted layer is an item in a portal that contains the properties and settings for a hosted data service or a layer in a hosted data service.Learn more.
Data attribution is required regardless of the type of API you are using to access data. For example, it applies to the use of any ArcGIS Maps SDKs, open source library, or third-party API. If you can not meet the data attributionData attribution is the requirement to display the names of data source providers in all applications when accessing ArcGIS content, layers, or services.Learn more requirements for any reason, please contact Esri.
You need to include data attribution if your application displays a map with one or more of the following:
The ArcGIS Basemap Styles serviceThe ArcGIS Basemap Styles service, also referred to as the Basemap Styles service, is a location service that provides basemap styles and data for the world. It returns styles as Mapbox styles and web maps, and data as vector tiles and/or map tiles. It supports all of the styles in the ArcGIS Basemap style and Open Basemap style family. An ArcGIS Location Platform or ArcGIS Online account is required to use the service.Learn more or ArcGIS Static Basemap Tiles serviceThe ArcGIS Static Basemap Tiles service, also known as the Static Basemap Tiles service, is a location service that provides basemap data as pre-rendered and pre-styled map tiles for the world. It supports key styles in the ArcGIS Basemap style family. An ArcGIS Location Platform account is required to use the services.Learn more.
An ArcGIS data serviceData services, also known as hosted data services, are services created dynamically to store and provide access to your data in ArcGIS. Examples are feature services, vector tile services, map tile services, image services, and scene services.Learn more such as a vector tile service, map tile service, or image service.
An ArcGIS hosted layerA hosted layer is an item in a portal that contains the properties and settings for a hosted data service or a layer in a hosted data service.Learn more or content itemAn item, also known as a content item, is a resource stored in a portal such as a web map, hosted layer, style, script tool, file, or notebook.Learn more.
An ArcGIS serviceA service, also known as an ArcGIS service, is software that supports an ArcGIS REST API and provides geospatial functionality or data. A service can be hosted by Esri or in ArcGIS Enterprise.Learn more in ArcGIS Online or ArcGIS Living Atlas.
An ArcGIS serviceA service, also known as an ArcGIS service, is software that supports an ArcGIS REST API and provides geospatial functionality or data. A service can be hosted by Esri or in ArcGIS Enterprise.Learn more in ArcGIS Enterprise.
Display requirements
The names of all data source providers must be clearly displayed on the map in your application.
Requirements
Display names directly on the map where it is always visible.
Display names for all ArcGIS basemap layersA basemap layer is the layer in a map or scene that displays basemap data. The data source for a basemap layer is typically a basemap service.Learn more and data layersA data layer is a layer that references geographic data from a file or a service and is used to visualize the data in a map or scene.Learn more in the map.
Display names for all ArcGIS services, itemsAn item, also known as a content item, is a resource stored in a portal such as a web map, hosted layer, style, script tool, file, or notebook.Learn more, and other sources accessed by the map.
Provide an expandable UI to display all names when they can not be displayed on small screens.
Do not obstruct names with other logo or visual elements.
Frequently verify names as data source providers can change.
The following are acceptable examples of displaying data attributionData attribution is the requirement to display the names of data source providers in all applications when accessing ArcGIS content, layers, or services.Learn more on a map:
Default
Joined
Collapsed
Expanded
From a menu
In a popup
Get attribution from a service
ArcGIS services return a data attribution text string with a list of the data source providers. Depending on the service, the string can be retrieved from the copyrightText or the attribution property (if it is available).
The steps to get data attribution text are:
Make a request to the ArcGIS service endpoint or metadata.
Retrieve the text from the copyrightText or attribution property.
Display the retrieved attribution text on your map.
The method of retrieving data attribution text depends on the type of service and the structure of the metadata returned. For example, you can use either the copyrightText or attribution property from the Basemap Styles serviceThe ArcGIS Basemap Styles service, also referred to as the Basemap Styles service, is a location service that provides basemap styles and data for the world. It returns styles as Mapbox styles and web maps, and data as vector tiles and/or map tiles. It supports all of the styles in the ArcGIS Basemap style and Open Basemap style family. An ArcGIS Location Platform or ArcGIS Online account is required to use the service.Learn more. Most services only support copyrightText however.
Below are examples of how to get the data attributionData attribution is the requirement to display the names of data source providers in all applications when accessing ArcGIS content, layers, or services.Learn more from different ArcGIS services:
Vector tile service includes the basemap styles serviceThe ArcGIS Basemap Styles service, also referred to as the Basemap Styles service, is a location service that provides basemap styles and data for the world. It returns styles as Mapbox styles and web maps, and data as vector tiles and/or map tiles. It supports all of the styles in the ArcGIS Basemap style and Open Basemap style family. An ArcGIS Location Platform or ArcGIS Online account is required to use the service.Learn more, custom basemap stylesA basemap style is a definition that controls the visual appearance of how geographic data in a basemap are displayed. It includes colors, backgrounds, outlines, labels, and other visual elements. Each basemap style emphasizes a specific type of cartographic theme and data.Learn more created with the ArcGIS Vector Tile Style Editor, and any other vector tile layersA vector tile layer is a data layer used to access and display tiled data and its corresponding styles.Learn more owned by Esri.
Map tile service includes the static basemap tiles service, imagery basemaps, and any other hosted map tile layersA hosted map tile layer is a hosted layer (item) in a portal that is used to manage the properties and settings of a map tile service.Learn more owned by Esri.
Feature service includes Esri-owned content in ArcGIS Living Atlas of the World and any other feature layersA feature layer (client-side) is a data layer that can access and display features from a feature service that has the same type of geometry and attribute fields.Learn more owned by Esri.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
{
"currentVersion": 11.2,
"serviceItemId": "3c164274a80748dda926a046525da610",
"serviceDescription": "This layer presents the counties (or county equivalents) of the United States in the 50 states and the District of Columbia. ",
"hasVersionedData": false,
"supportsDisconnectedEditing": false,
"hasStaticData": false,
"hasSharedDomains": false,
"maxRecordCount": 2000,
"supportedQueryFormats": "JSON",
"supportsVCSProjection": false,
"supportedExportFormats": "csv,shapefile,sqlite,geoPackage,filegdb,featureCollection,geojson,kml,excel",
"supportedConvertFileFormats": "JSON,PBF",
"supportedConvertContentFormats": "LayerEditCollection",
"capabilities": "Query,Extract",
"description": "...",
"copyrightText": "Esri; U.S. Department of Commerce, Census Bureau; U.S. Department of Commerce (DOC), National Oceanic and Atmospheric Administration (NOAA), National Ocean Service (NOS), National Geodetic Survey (NGS)",
...
}
Get attribution from an item
If attribution is not available from a service, you can get the attribution text from the itemAn item, also known as a content item, is a resource stored in a portal such as a web map, hosted layer, style, script tool, file, or notebook.Learn more page in ArcGIS.
The steps to get the text are:
Go to the ArcGIS portalArcGIS portal, also known as a portal, is a website with applications and tools that can be used to create, manage, access, and share geospatial content and data. It supports security and authentication, developer credentials, content and data service management, user and group management, and site administration. A portal can be hosted in Esri's infrastructure or your own infrastructure.Learn more that contains the service, e.g. ArcGIS Online.
Use Search to find the item in the portal. Hint: Filter by layer type to refine your search.
In the item page, get the text from the Acknowledgments section.
Display the appropriate data attribution text in your application. See Code examples.
Below is an example of where to get the data attribution text from the USA Census States item:
ArcGIS Maps SDK for Native Apps displays Esri and data attribution text automatically. No additional attribution work is required.
ArcGIS Maps SDK for .NETArcGIS Maps SDK for .NETArcGIS Maps SDK for KotlinArcGIS Maps SDK for SwiftArcGIS Maps SDK for JavaArcGIS Maps SDK for QtArcGIS Maps SDK for Flutter
MapLibre GL JS requires you to retrieve the copyrightText from the service's metadata and then display the Esri and data attribution text manually in the attribution control.
OpenLayers requires you to retrieve the copyrightText from the service's metadata and then display the Esri and data attribution text manually in the attribution control.
CesiumJS requires you to retrieve the copyrightText from the service's metadata and then display the Esri and data attribution text manually in the attribution control.
Display attribution in a map that uses basemap and data services
Applications that contain basemapArcGIS Basemap services, also referred to as Basemap services, are location services hosted by Esri that provide data sources for building mapping applications. It includes the ArcGIS Basemap Styles service and ArcGIS Static Basemap Tiles service. Each service provides a specific type of basemap data and set of styles.Learn more and data servicesData services, also known as hosted data services, are services created dynamically to store and provide access to your data in ArcGIS. Examples are feature services, vector tile services, map tile services, image services, and scene services.Learn more are required to display data attributionData attribution is the requirement to display the names of data source providers in all applications when accessing ArcGIS content, layers, or services.Learn more for all layers and data sources in the map.
ArcGIS Maps SDK for JavaScript
ArcGIS Maps SDK for JavaScript displays Esri and data attribution for both the basemap and feature layer automatically. No additional work is required.
ArcGIS Maps SDK for Native Apps displays Esri and data attribution for both the basemap and feature layer automatically. No additional work is required.
ArcGIS Maps SDK for .NETArcGIS Maps SDK for .NETArcGIS Maps SDK for KotlinArcGIS Maps SDK for SwiftArcGIS Maps SDK for QtArcGIS Maps SDK for Flutter
OpenLayers displays data attribution for the basemap. You need to add the Esri and data attribution text from the layer's item pageAn item page is a web page in ArcGIS Online or the developer dashboard used to access and manage the properties for an item and the content it references such as a web map, hosted layer, or file.Learn more manually.
Expand
Use dark colors for code blocksCopy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
source: new ol.source.Vector({
format: new ol.format.GeoJSON(),
url: `https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/USA%20States/FeatureServer/0/query?f=pgeojson&where=1=1&outFields=*&&returnGeometry=true`,
attributions: [
"Esri; U.S. Department of Commerce, Census Bureau; U.S. Department of Commerce (DOC), National Oceanic and Atmospheric Administration (NOAA), National Ocean Service (NOS), National Geodetic Survey (NGS)",
],
// retrieved from https://www.arcgis.com/home/item.html?id=e6f74a58bee742a2a040f80d99c36bb9 }),
Expand
CesiumJS
CesiumJS displays data attribution for the basemap. You need to add the Esri and data attribution text from the layer's item pageAn item page is a web page in ArcGIS Online or the developer dashboard used to access and manage the properties for an item and the content it references such as a web map, hosted layer, or file.Learn more manually.
Expand
Use dark colors for code blocksCopy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
const data = Cesium.GeoJsonDataSource.load(response, {
clampToGround: true,
credit: new Cesium.Credit(
"Esri; U.S. Department of Commerce, Census Bureau; U.S. Department of Commerce (DOC), National Oceanic and Atmospheric Administration (NOAA), National Ocean Service (NOS), National Geodetic Survey (NGS)",
false ), // retrieved from https://www.arcgis.com/home/item.html?id=e6f74a58bee742a2a040f80d99c36bb9 })
Expand
Display attribution when not using a map
ArcGIS REST JS
This example uses the autosuggest feature from suggest(). To provide Esri attributionEsri attribution is the requirement to display "Powered by Esri" text in all applications that use Esri technology including ArcGIS Maps SDKs, APIs, content, or services.Learn more, you can the Results powered by Esri text manually to the control.
Autosuggest results with "Results powered by Esri" text.
