How to work with items | Documentation

The general steps to work with items.

1. Create an item

To create and access 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, you can use interactive tools, client APIsA Client API is a web, native, or scripting Application Programming Interface (including all ArcGIS, open source, and third-party APIs) that has mapping capabilities and can be used to access ArcGIS location services.Learn more, or the REST API.

The typical workflow is:

Create and store an item with tools, such as ArcGIS Online and the Location Platform DashboardThe Location Platform Dashboard is a dashboard in the ArcGIS Location Platform website used to manage billing, view developer credentials, and monitor layers and data service usage. It can only be accessed with an ArcGIS Location Platform account.Learn more.
Manage your items with toolsTools, also known as developer tools, are ArcGIS software applications such as portal and ArcGIS Pro that developers can use to prepare content and data for custom applications they are building.Learn more.
Access items in the portal service with a client APIA Client API is a web, native, or scripting Application Programming Interface (including all ArcGIS, open source, and third-party APIs) that has mapping capabilities and can be used to access ArcGIS location services.Learn more or the REST API.

ArcGIS hosted portal content management diagram showing the workflow to create, manage, and access content items.

Create, manage, and access content items using the portal service.

Examples

You can create and store new items in the portal by specifying the item type and other required parameters. This request requires an access tokenAn access token is an authorization string that provides access to secure ArcGIS content, data, and services. Its capabilities are determined by the privileges it supports. It is obtained by implementing API key authentication, User authentication, or App authentication.Learn more.

This example creates a web map item.

NOTE: Child data should also be provided to define the JSON for the web map itself. See Create a web map to learn how to create a web map and get the JSON.

APIs

ArcGIS Maps SDK for JavaScript

ArcGIS API for Python

ArcGIS REST JS

Use dark colors for code blocksCopy
const portal = new Portal();
portal.url = "https://www.arcgis.com/"
portal.authMode = "immediate";
// Prompts for username and password
portal.load()
  .then(()=> {
    const item = new PortalItem({
      title: "World geography",
      description: "This is a map of the world",
      tags: ["map", "world", "geography"],
      type: "Web Map"
    });
      const params = {
        item: item
      };
      portal.user.addItem(params).then((response)=>{
        console.log(response); // Item information
      });
});
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"
}

2. Manage an item

The easiest way to access and manage an item is to use an 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. An item page is a web page where you can access item properties through tools such as 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 and the Location Platform DashboardThe Location Platform Dashboard is a dashboard in the ArcGIS Location Platform website used to manage billing, view developer credentials, and monitor layers and data service usage. It can only be accessed with an ArcGIS Location Platform account.Learn more.

Item pages

Access an item page to view and manage the item properties.

Public and private URL examples:

Use dark colors for code blocksCopy
https://www.arcgis.com/home/item.html?id=<ITEM_ID>&token=<ACCESS_TOKEN>

Public URL example:

Use dark colors for code blocksCopy
https://www.arcgis.com/home/item.html?id=5a5147abe878444cbac68dea9f2f64e7

Private URL example:

Use dark colors for code blocksCopy
https://www.arcgis.com/home/item.html?id=<ITEM_ID>&token=<ACCESS_TOKEN>

To share an item with different users, set the access property. The scope can be public (everyone), organization (your organization members only), group (private or public group), or private (only you).

You must be the item's owner or an administrator for the organization to change this property.

APIs

ArcGIS Maps SDK for JavaScript

ArcGIS Maps SDK for .NET

ArcGIS Maps SDK for Kotlin

ArcGIS Maps SDK for Swift

ArcGIS API for Python

ArcGIS REST JS

Use dark colors for code blocksCopy
      // Replace with your own credentials
      var username = "USERNAME"
      var password = "PASSWORD"
      var itemId = "ITEM_ID"

      // Sign in to ArcGIS Online
      IdentityManager.registerToken({
        server: "https://www.arcgis.com/sharing/rest",
        token: "YOUR_ACCESS_TOKEN",
      })

      // Create a new Portal instance
      var portal = new Portal()
      portal.load().then(function () {
        // Load the item
        var item = new PortalItem({
          id: itemId,
          portal: portal,
        })

        item.load().then(function () {
          // Share the item with everyone
          item
            .share({
              everyone: true,
            })
            .then(function (response) {
              console.log("Item shared successfully:", response)
            })
        })
Go to API reference

REST API

cURL

HTTP

Use dark colors for code blocksCopy
curl https://www.arcgis.com/sharing/rest/content/users/<YOUR_ORG>/items/<ITEM_ID>/share \
-d 'everyone=true' \
-d 'org=true' \
-d 'groups=<GROUP_IDs>' \
-d 'f=pjson' \
  -d 'token=<ACCESS_TOKEN>'
Run in Postman

Use dark colors for code blocksCopy
{"results": [{"itemId": "ITEM_ID",
  "success": true,
  "notSharedWith": []}]} // Groups item not shared with

3. Access an item

To access and work with items in the portal, you can use client APIsA Client API is a web, native, or scripting Application Programming Interface (including all ArcGIS, open source, and third-party APIs) that has mapping capabilities and can be used to access ArcGIS location services.Learn more or the REST API.

Get an item

To access an item and its properties, you can access it by item ID. The response contains the item properties.

The public example shows how to access a public web mapA 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 item by its ID. The private example shows how to access any private item that you own by ID.

APIs

ArcGIS Maps SDK for JavaScript

ArcGIS Maps SDK for .NET

ArcGIS Maps SDK for Flutter

ArcGIS API for Python

ArcGIS REST JS

Use dark colors for code blocksCopy
    const item = new PortalItem({
      id: "5a5147abe878444cbac68dea9f2f64e7",
      portal: "https://www.arcgis.com/sharing/rest"
    });
    item.load().then((response)=>{
      console.log(response);
    });
Go to API reference

ArcGIS Maps SDK for JavaScript

ArcGIS Maps SDK for .NET

ArcGIS API for Python

ArcGIS REST JS

Expand
Use dark colors for code blocksCopy
    const portal = new Portal({
      url: "https://www.arcgis.com/",
      authMode: "immediate"
    });

    // OR
    esriConfig.apiKey = "YOUR_ACCESS_TOKEN" // Scoped to access item below

    const portalItem = new PortalItem({
      portal: portal,
      id: "ITEM_ID"
    });
    portalItem.load().then((response)=>{
      console.log(response);
    });
Go to API reference

REST API

cURL

HTTP

Use dark colors for code blocksCopy
## Public

curl https://www.arcgis.com/sharing/rest/content/items/5a5147abe878444cbac68dea9f2f64e7 \
-d 'f=pjson'

## Private

curl https://www.arcgis.com/sharing/rest/content/items/<ITEM_ID> \
-d 'f=pjson' \
-d 'token=<ACCESS_TOKEN>'
Run in Postman

Response

Use dark colors for code blocksCopy
// Public

{
  "id": "5a5147abe878444cbac68dea9f2f64e7",
  "owner": "esri_devlabs",
  "orgId": "GVgbJbqm8hXASVYi",
  "created": 1569537110000,
  "modified": 1569537111000,
  "guid": null,
  "name": null,
  "title": "Seven Natural Wonders of the World Map",
  "type": "Web Map"
}

// Private

{
  "id": "ITEM_ID",
  "owner": "OWNER",
  "orgId": "ORG_ID",
  "created": "DATE_CREATED",
  "modified": "DATE_MODIFIED",
  "guid": null,
  "name": null,
  "title": "ITEM_TITLE",
  "type": "ITEM_TYPE"
}

Get item data

Items can contain child data. The data is typically stored as text (JSON) or as a reference to services, files, or other resources.

The public example gets the child data for a public web mapA 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 item. The private example gets the child data for an item that you own. The data returned is the JSON. To create your own private item, see Create a web map.

APIs

ArcGIS Maps SDK for JavaScript

ArcGIS API for Python

ArcGIS REST JS

Use dark colors for code blocksCopy
  const item = new PortalItem({
    portal: "https://www.arcgis.com/sharing/rest",
    id: "5a5147abe878444cbac68dea9f2f64e7"
  });
  item.load().then(()=>{
    item.fetchData().then((response)=>{
      console.log(response);
    });
  });

ArcGIS Maps SDK for JavaScript

ArcGIS API for Python

ArcGIS REST JS

Use dark colors for code blocksCopy
const portal = new Portal({
  url: "https://www.arcgis.com/",
  authMode: "immediate"
});

// OR
esriConfig.apiKey = "YOUR_ACCESS_TOKEN"

const portalItem = new PortalItem({
  portal: portal,
  id: "ITEM_ID" // private
});
portalItem.load().then(()=>{
  portalItem.fetchData().then((response)=>{
    console.log(response);
  });
});

REST API

cURL

HTTP

Use dark colors for code blocksCopy
## Public

curl https://www.arcgis.com/sharing/rest/content/items/5a5147abe878444cbac68dea9f2f64e7/data \
-d 'f=pjson'

## Private

curl https://www.arcgis.com/sharing/rest/content/items/<ITEM_ID>/data \
-d 'f=pjson' \
-d 'token=<ACCESS_TOKEN>'
Run in Postman

Use dark colors for code blocksCopy
// Public

{
  "operationalLayers":[
     {
        "id":"Seven_Natural_Wonders_of_the_World_6051",
        "layerType":"ArcGISFeatureLayer",
        "url":"https://services.arcgis.com/uCXeTVveQzP4IIcx/arcgis/rest/services/Seven_Natual_Wonders_of_the_World/FeatureServer/0",
        "visibility":true,
        "opacity":1,
        "title":"Seven Natural Wonders of the World",
        "itemId":"da7cda8d38224b368bc74cc7d6f05d0f"
     }
  ],
  "baseMap":{
     "baseMapLayer":[
        {
           "id":"defaultBasemap",
           "layerType":"ArcGISTiledMapServiceLayer",
           "url":"https://services.arcgisonline.com/ArcGIS/rest/services/World_Topo_Map/MapServer",
           "visibility":true,
           "opacity":1,
           "itle":"Topographic"
        }
     ],
     "title":"Topographic"
  },
  "spatialReference":{
     "wkid":102100,
     "latestWkid":3857
  },
  "authoringApp":"WebMapViewer",
  "authoringAppVersion":"5.4",
  "version":"2.11"
}

// Private

{
   "operationalLayers":[
      {
         "id":"",
         "layerType":"",
         "url": "ITEM_URL"
         "visibility":true,
         "opacity":1,
         "title":"YOUR_ITEM_TITLE",
         "itemId":"ITEM_ID"
      }
   ],
   "baseMap":{
      "baseMapLayer":[
         {
            "id":"defaultBasemap",
            "layerType":"ArcGISTiledMapServiceLayer",
            "url":"https://services.arcgisonline.com/ArcGIS/rest/services/World_Topo_Map/MapServer",
            "visibility":true,
            "opacity":1,
            "itle":"TILE"
         }
      ],
      "title":"BASEMAP_TITLE"
   },
   "spatialReference":{
      "wkid":102100,
      "latestWkid":3857
   },
   "authoringApp":"WebMapViewer",
   "authoringAppVersion":"5.4",
   "version":"2.11"
 }

Search for an item

Use a query to search for items in the portal. If many results are returned, use paging.

The public example searches for all items that contain the string, type, and owner. The private example searches for your private items that are web maps.

APIs

ArcGIS Maps SDK for JavaScript

ArcGIS API for Python

ArcGIS REST JS

Use dark colors for code blocksCopy
const portal = new Portal({
  url: "https://www.arcgis.com/"
});
portal.load().then(()=>{
  const query = {
    query: "title: Seven Natural Wonders, type: web map, owner: esri_devlabs"
  };
  portal.queryItems(query).then((response)=>{
    console.log(response);
  });
});
Go to API reference

ArcGIS Maps SDK for JavaScript

ArcGIS API for Python

ArcGIS REST JS

Use dark colors for code blocksCopy
const portal = new Portal({
  url: "https://www.arcgis.com/",
  authMode = "immediate"
});
portal.load().then(()=>{
  const query = {
    query: `type: web map, owner: ${portal.user.username}`
  };
  portal.queryItems(query).then((response)=>{
    console.log(response);
  });
});
Go to API reference

REST API

cURL

HTTP

Use dark colors for code blocksCopy
## Public

curl https://www.arcgis.com/sharing/rest/search \
-d 'q=title:"Seven Natural Wonders of the World" AND type:"web map" AND owner:"esri_devlabs"' \
-d 'f=pjson'

## Private

curl https://www.arcgis.com/sharing/rest/search \
-d 'q=title:"Seven Natural Wonders of the World" AND type:"web map" AND owner:"<YOUR_USER_ID>"' \
-d 'f=pjson'
-d 'token=<ACCESS_TOKEN>'
Run in Postman

Use dark colors for code blocksCopy
{
  "query": "title:\"Seven Natural Wonders of the World\" AND type:\"web map\" AND owner:\"esri_devlabs\"",
  "total": 1,
  "start": 1,
  "num": 10,
  "nextStart": -1,
  "results": [{
    "id": "5a5147abe878444cbac68dea9f2f64e7",
    "owner": "esri_devlabs",
    "created": 1569537110000,

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.

ArcGIS Enterprise

Create, manage, analyze, and share data, maps, and applications in your organization.

Portal

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

Map Viewer

Create, explore, and share web maps for 2D applications.

Scene Viewer

Create, style, and explore web scenes.

Vector Tile Style Editor

Create styles for basemap and vector tile layers.

Content management tools

Create, manage, organize, and share items in a portal.

Data management tools

Import data and create hosted layers and data services. Upload and manage documents, images, and other files.

Spatial analysis tools

Perform feature and raster analysis to create new datasets with the Map Viewer.

Developer credentials tool

Create API key and OAuth 2.0 developer credentials for custom applications.

Items

Manage and share items.

ArcGIS Pro

Create, style, and explore maps and scenes.

Geoprocessing tools

Import, manage, and analyze data.

1. Create an item

Examples

APIs

REST API

2. Manage an item

Item pages

Share an item

APIs

REST API

3. Access an item

Get an item

APIs

REST API

Response

Get item data

APIs

REST API

Search for an item

APIs

REST API

Services

Portal service

API support

Tools

ArcGIS Enterprise

Portal

Map Viewer

Scene Viewer

Vector Tile Style Editor

Content management tools

Data management tools

Spatial analysis tools

Developer credentials tool

Items

ArcGIS Pro

Geoprocessing tools