Use the following best practices to improve the display of your content on a site and in search results, by editing individual items.
Improve the clarity and usefulness of your content by ensuring that it has complete metadata. If you see the Edit button on an item's explore page or full details page, you can edit basic details. Otherwise, edit the item in ArcGIS Online (any non-item resource such as a layer or a published service that is not an item but part of an item).
- Title—Use a title that is clear and informative. For layers in map or feature services, change the title locally, and publish the service with clean titles.
Underscores are removed from the title.
- Thumbnail—The thumbnail image is displayed on layout cards and content views.
- Description—Create a description that is clear and informative, as it is shown on content views and search results.
- Field aliases—For tabular data, 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.
If you add a Creative Commons license (CC0, CC BY, CC BY-SA) by either the name or the 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 in map and feature services will have the same tags as those set for the entire service in ArcGIS Online.
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.
Only the following HTML tags will be respected in the Description and License fields in ArcGIS Hub. Text in other tags will appear inline: 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.
Basemaps and extents
You can choose the basemap (in site Settings) to display on a spatial dataset's explore page. Configure both basemaps and extents in ArcGIS Hub and ArcGIS Online. You can set the extent for an item in ArcGIS Online: open the item's details page, click Settings, and choose Set Extent. Save these changes and return to ArcGIS Hub to save and publish the site. If you see the Edit button in ArcGIS Hub item details, you can add or modify metadata there, such as item location (extent). By default, ArcGIS Hub zooms to a dataset's features on a content preview page, but the extent settings of the site may apply if no item extent has been set.
If the item's explore view displays an extent that seems to cover the world or is anchored in Null Island, update the spatial extent for the ArcGIS Online item.
It's useful to set a location for an item so that it appears in map-based searches. Setting an extent also helps users understand the geographic area your content represents or to which it is relevant.
All sites have an Embedded Apps setting that controls how applications open when a someone clicks on a configured gallery card, application card, or search result. Enable this setting if you want the application to open within the context of your site's header and global navigation bar. The information side panel is also available. If disabled, the application will open externally.
Similar to the Embedded Apps setting, the Embedded links setting controls how content registered as a document link opens. Enable this setting if you want the application to open within the context of your site's header and global navigation bar. The information side panel also becomes available. If disabled, the application will open externally.
A content view can show three potential dates for all datasets (/data item types): Info Updated, Data Updated, and Published Date. For all remaining content families, Data Updated and Published Date are shown.
The Info Updated section show viewers when the metadata was last updated relative to its underlying data.
If editor tracking is enabled, any changes made to the underlying data will not impact the date for the Info Updated section.
- If frequency is set for the item and a custom date is set in the metadata editor, the frequency appears with the date that metadata was last edited
- If a frequency is set for the item, but no custom date is available, the frequency is shown
- If neither frequency or custom date is available, the date that the metadata was last modified is shown
The Data Updated section uses the revision date for an item which refers to the date the item was last modified if editor tracking is enabled. Revision dates are also changed in the item's metadata editor in ArcGIS Online by setting a custom date.
- If neither of these configurations are applied to the item, the content view displays the date for the last time the item was modified
- If a dataset has a designated frequency and a revision date, frequency is shown
- If a custom date is set in the metadata (Metadata Date), that date is shown
- If no dates are set in the item's metadata, the date that the item was last modified is shown
The Published Date references the date that the item was created if no custom publication date is provided in the item's metadata.
- The last time the item was edited or opened in ArcGIS Online
- The last time an update was made to the service (if editor tracking is enabled)
Verified organization badges
If your ArcGIS Online organization is verified, an authoritative badge appears on the side panel when viewing an item's content view. To verify your ArcGIS Online, see Organization verification.