Create an item

An 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 in a 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 represents different types of geographic data and resources. Items can include web mapsA web map is a map stored as a JSON object that defines properties such as the basemap layer, data layers, layer styles, and pop-up styles. Its JSON structure is defined by the web map specification.Learn more, layersA layer is a reference to a collection of geographic data that is used to access and display data. The data for layers are typically provided by the basemap layer service and data services.Learn more, web applicationsA web app is a mapping, analysis, or data-driven application that runs in a web browser. In most cases they are configurable and are hosted in ArcGIS.Learn more, tools, notebooksNotebooks is a Jupyter Notebook environment in ArcGIS that provides an interface for scripting, executing Python code, creating visualizations, and using data tools. Each notebook is stored as an item in a portal or .ipynb file locally.Learn more, and other resources that support spatial analysis and visualization.

Each item in a portal is associated with metadata, including a title, description, tags, and sharing settings. Items can be created, accessed, shared, and managed within an organization through the 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 in a portal. Users can control item visibility by configuring sharing levelsSharing level is the security setting assigned to an item in a portal that controls which users can access the resource. The sharing levels are Owner, Organization, Groups, and Everyone.Learn more: private, organization, group or public.

You use the portal serviceA portal service provides the functionality to securely create, access, and manage content, data services, users, and groups in a portal. The service can be hosted by Esri or in ArcGIS Enterprise.Learn more for item creation and management in ArcGIS Location PlatformArcGIS Location Platform, formerly known as ArcGIS Platform, is a Platform as a Service (PaaS) product that gives developers access to location services, APIs, and tools to build mapping and spatial analysis applications. It is subscription-based and requires an ArcGIS Location Platform account.Learn more, ArcGIS OnlineArcGIS Online is a GIS mapping, analytics, data hosting, and content management software as a service (SaaS) product. It includes applications, tools, APIs, and location services for users and developers. It is subscription-based and requires an ArcGIS Online account.Learn more, or ArcGIS EnterpriseArcGIS Enterprise is a GIS mapping, analytics, data hosting, and content management product that can be hosted on-premise or in a cloud infrastructure. It includes software, applications, tools, APIs, and services for users and developers.Learn more. Using the portal service, developers and administrators can programmatically create, update, and delete items, as well as configure permissions and ownership settings.

Code examples

Below are example on how to create items in a portal.

1
2
3
4
5
6
7
8
9
10
from arcgis.gis import GIS
gis = GIS(username="USERNAME", password="PASSWORD")
item = {
    "title": "Word geography",
    "description": "This is a map of the world",
    "tags": ["map", "world", "geography"],
    "type": "Web Map"
}
results = gis.content.add(item)
print(results)

1
2
3
4
5
6
7
curl https://www.arcgis.com/sharing/rest/content/users/<USER_NAME>/addItem \
-d 'f=pjson' \
-d 'title=World geography' \
-d 'description=This is the map of the world' \
  -d 'type=Web Map' \
-d 'tags=map, world, geography' \
-d 'token=<ACCESS_TOKEN>'

1
2
3
4
{
  "success": true,
  "id": "ITEM_ID"
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
from arcgis.gis import GIS
import getpass

gis = GIS(
  url="https://www.arcgis.com",
  username="username",
  password=getpass.getpass("Enter password:")
)

trailhead_properties = {
  "title": "Trailheads",
  "description": "Trailheads imported from CSV file",
  "tags": "LA Trailheads"
}

csv_file = './data/LA_Hub_datasets/LA_Hub_datasets/Trailheads.csv'
csv_item = gis.content.add(trailhead_properties, csv_file)

trailhead_service = csv_item.publish()
trailhead_service

Tutorials

Use tools to create different types of contentContent is a collection of items in a portal that belong to a user, group, or organization.Learn more and build content-driven applications.

Import data to create a feature layer

Use data management tools to import files and create a feature layer in a feature service.

ArcGIS portal

Manage a feature layer

Use a hosted feature layer item to set the properties and settings of a feature layer in a feature service.

ArcGIS portal

Add a feature layer

Access and display point, line, and polygon features from a feature service.

JavaScript Maps SDKKotlin Maps SDKSwift Maps SDK.NET Maps SDKJava Maps SDKQt Maps SDKLeafletMapLibre GL JSOpenLayersCesiumJSPython APIREST JS

Services

API support

Tools

Use tools to access the portal and create and manage content for applications.