Create an item | Documentation

ArcGIS hosted portal content page displaying items in a portal.

Content items in an organization in ArcGIS portal.

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.

Create a web map

Create a new web map item.

ArcGIS API for Python

ArcGIS REST JS

Use dark colors for code blocks

Copy

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

# To learn more about using profiles, go to
# https://developers.arcgis.com/python/latest/guide/working-with-different-authentication-schemes/#storing-your-credentials-locally
portal = GIS(profile="YOUR_ARCGIS_ACCOUNT")
root_folder = portal.content.folders.get()

new_item_props = ItemProperties(
    title= "Word geography",
    description= "This is a map of the world",
    tags= ["map", "world", "geography"],
    item_type=ItemTypeEnum.WEB_MAP
)

add_item_job = root_folder.add(item_properties=new_item_props)
if not add_item_job.done():
    print("add item job processing...")
else:
    print(add_item_job.result())

Go to API reference

REST API

cURL

HTTP

Use dark colors for code blocks

Copy

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>'

Run in Postman

Use dark colors for code blocksCopy
{
  "success": true,
  "id": "ITEM_ID"
}

Import a CSV file

Create an item in a portal by importing a CSV file.

Use dark colors for code blocksCopy
from arcgis.gis import GIS, ItemProperties, ItemTypeEnum

portal = GIS(
  username="<YOUR_USERNAME>",
  password="<YOUR_PASSWORD>"
)
root_folder = portal.content.folders.get() # root portal folder

trailhead_item_props = ItemProperties(
  title="Trailheads",
  description="Trailheads imported from CSV file",
  tags="LA Trailheads",
  item_type=ItemTypeEnum.CSV
)

csv_file = './data/LA_Hub_datasets/LA_Hub_datasets/Trailheads.csv'
csv_item = root_folder.add(item_properties=trailhead_item_props, file=csv_file)
if not csv_item.done():
  print("CSV item processing...")
else:
  print("CSV item processing complete.")

  trailhead_service = csv_item.publish()
  print(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.

Portal interface showing My Content page showing a table of items such as hosted feature layers, tile layers, CSV files, and web maps, with Add Item and Create controls and filtering options in the left sidebar.

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

A hosted feature layer item page showing management actions such as open in map or scene viewer, publish, create view layer, export data, update data, and share.

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

A topographic map of the Malibu and Santa Monica Mountains area with hiking trails styled in bright purple and trailhead points marked by black hiker icons.

Add a feature layer

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

JavaScript Maps SDK Kotlin Maps SDK Swift Maps SDK .NET Maps SDK Java Maps SDK Qt Maps SDK Leaflet MapLibre GL JS OpenLayers CesiumJS Python API REST JS

Services

Portal service

Store, manage, and access private and public content.

API support

	Search	Items	Users	Groups	Settings	Security
ArcGIS Maps SDK for JavaScript			¹	¹	¹	¹
ArcGIS Maps SDK for .NET			¹	¹	¹	¹
ArcGIS Maps SDK for Kotlin			¹	¹	¹	¹
ArcGIS Maps SDK for Swift			¹	¹	¹	¹
ArcGIS Maps SDK for Flutter			¹	¹	¹	¹
ArcGIS Maps SDK for Java			¹	¹	¹	¹
ArcGIS Maps SDK for Qt			¹	¹	¹	¹
ArcGIS API for Python
ArcGIS REST JS
Leaflet	²	²	²	²	²	²
MapLibre GL JS	²	²	²	²	²	²
OpenLayers	²	²	²	²	²	²
CesiumJS	²	²	²	²	²	²

Full supportPartial supportNo support

1. Limited operations, use HTTP requests.
2. Access via ArcGIS REST JS.

Tools

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

Portal

Create, manage, and access content and data services for applications.