Skip To Content

Prepare your content

Using the following best practices, you can improve the display of your content on a site and in search results by editing individual items in ArcGIS Online.

Note:

Core team members can only edit their own items and items shared to the core team group.

Before you get started

Keep the following considerations in mind when adding content to a site or initiative:

Supported item types

The following list includes all items supported by ArcGIS Hub.

Data types
  • ArcPad package (.zip)
  • ArcGIS server stream services
  • Annotation layer
  • Comma-separated values (CSV) collection (.zip)
  • Comma-separated values (CSV) file (.csv)
  • Dataset
  • Explorer layer
  • Feature service (URL)
  • File geodatabase (.zip)
  • Geoprocessing sample (.zip)
  • GeoJSON file(.geojson or .json)
  • Hosted feature services
  • Image file (.jpg, .jpeg, .png,tif, or .tiff)
  • Image collection (.zip)
  • Image service (URL)
  • Image service layer
  • Keyhole markup language (KML) (.zip)
  • Keyhole markup language (KML) collection (.zip)
  • Layer (.lyr)
  • Layer package (.lpk or .lpkx)
  • Mosaic layer
  • Map service definition (.msd)
  • Network dataset layer
  • Open Geospatial Consortium (OGC) Web Map Feature Service (WFS) (URL)
  • Open Geospatial Consortium (OGC) Web Map Service (WMS) (URL)
  • Project template
  • Project package (.ppkx)
  • Raster catalog layer
  • Raster layer
  • Rule package (.rpk)
  • Shapefile (.zip)
  • Scene service (URL)
  • Scene layer package (.spk or .slpk)
  • Stream service (URL)
  • SQLite Geodatabase
  • Vector Tile package (.vtpk)
  • Vector Tile Service
  • Table
  • Terrain layer
  • Tiled service layer
Maps and Apps
  • Application (URL)
  • 360 VR Experience (.3vr)
  • City Engine Web Scene (.3ws)
  • Computer-Aided Design (CAD) drawing (.zip)
  • Desktop application (.zip)
  • Desktop application Template (.zip)
  • Map
  • Map Package (.mpk)
  • Map Template (.mxt)
  • Map Service
  • Operations Dashboard add-in (.opdashboardaddin)
  • Project Template (.aptx)
  • Web Map Application
  • Web scenes
Documents
  • Document link (URL to online document)
  • iWork Keynote (.zip)
  • iWork Pages (.zip)
  • Microsoft Excel document (.xls or .xlsx)
  • Microsoft PowerPoint (.ppt or .pptx)
  • Portable Document Format (.pdf)

Improve data quality

Using the following best practices, you can improve the display of your content on a site and in search results by editing individual items in ArcGIS Online.

  • Title—For individual items, change the title in ArcGIS Online to be clear and informative. For layers within map or feature services, change the title locally, and publish the service with clean titles.
    Note:

    ArcGIS Hub will remove any underscores in a title.

  • Description—An item's description is visible in search results and should be clear and informative..
    Note:

    Layers within map or feature service will take the description of the entire service. If you do not enter a description, ArcGIS Hub will automatically state Description not provided.

  • Field aliases—Change complex GIS data field names to a more user-friendly description of the content of the field. The table on an item's preview page will supply the field name, but not the field alias.
  • License—You can add a license in the Terms of Use section of your item on ArcGIS Online.
    Tip:

    If you add a Creative Commons license (CC0, CC BY, CC BY-SA) by either the name or URL, the data's page will display the Creative Commons license icon and will link to the appropriate license details web page. If you add an Open Data Commons license (PDDL, ODbL, ODC-By), the dataset page will display the license name and link to the appropriate license details web page.

  • Tags—Tags help users discover your datasets through searches. For individual items, add tags in ArcGIS Online. All layers within map and feature services will have the same tags as set for the entire service in ArcGIS Online.
  • ThumbnailsArcGIS Online item thumbnails will appear when an item is displayed on a site or page using the gallery card. All layers within map and feature services will have the same thumbnail.
  • Structured MetadataAdd official metadata files to the ArcGIS Online item and users can access it via ArcGIS Hub.
Note:

ArcGIS Hub downloads will change the data schema so that all values will be within the signed range of integer values that can be stored in 32 bits. This means that field lengths, field precision, and scale may be altered in the download. The data itself will not change.

Caution:

Only the following HTML tags will be respected in the Description and License fields on ArcGIS Hub. Text in other tags will appear in-line: h3, h4, h5, h6, img, blockquote, p, a, ul, ol, nl, li, b, i, strong, em, strike, code, hr, br, div, table, thead, caption, tbody, tr, th, td, pre.

Register services

Services must be registered to ArcGIS Online to be added to ArcGIS Hub. When working with map and feature services, you can register services containing multiple layers, or register the individual layers themselves.

Register services with multiple layers

This is a quicker way of getting your data live, but it gives you less control over search results and an item's metadata. All layers within the service will have the same description and the same tags, and all layers will appear in search results when a tag or the service name is called.

Register individual layers

Individual layers provide greater control over the item's metadata—you can edit individual titles and descriptions within ArcGIS Online. Each layer will have different tags as set in ArcGIS Online, which will provide better search results for the end user.

Tip:

To learn more about registering services and service configuration, see Server configuration details.

Add additional download files

All (vector) datasets are automatically available for download as CSV files, KML files, and shapefiles and accessible in the GeoJSON and GeoService APIs. You can add additional download files or related documents by adding custom distributions to the dataset's structured metadata. This is a good way to support CAD file download formats or file geodatabases for nonhosted feature services. Additional download files that you add in the metadata will appear as options in the download section of the dataset page on ArcGIS Hub.

To add additional download files, follow these steps:

  1. On the item page in the home application, click Metadata.
    Note:
    If you do not see a metadata button, you must have an administrator enable metadata for your organization.
  2. On the metadata form, click Distribution.
  3. On the Online Resource page that appears, click the plus sign.
  4. Enter a URL to your download file or external related link.
  5. Enter a name for the file.
  6. Change the Function parameter to Download.
Note:

You can add as many additional download files as you want by repeating steps 3 through 6.

Caution:

Entering additional distributions in the metadata will expose the entire metadata to the user in Hub. Datasets are encouraged to have complete, structured metadata.

Edit items in ArcGIS Online

The content you share with ArcGIS Hub is stored as part of your organization's subscription to ArcGIS Online. That's why you have to edit specific item details in ArcGIS Online. Follow these steps to get started.