Add items

If your account has privileges to create content, you can add files from your device, items from the web, and apps to ArcGIS Online. You can also save maps and publish apps. Your items are accessible only to you until you share them with others.

Add files from your device

You can add supported files from your computer to the website and share the files so others can download and open the files in desktop applications. When you share comma-separated values (CSV) files with everyone (public), you can use the URL that appears on the item page to add the CSV as a web layer. In addition, organizational accounts can add image files and use the URL to show images in web apps, pop-ups, and so on. You need to share the CSV and image files with everyone (public) to see the URL on the item page.

If you have privileges to publish hosted feature layers, you can publish a hosted feature layer when you upload supported files such as zipped shapefiles and Microsoft Excel spreadsheets.

Note:

Once published, data uploaded from a shapefile or file geodatabase will be converted to Web Mercator projection.

  1. Verify that you are signed in and have privileges to create content.
  2. From the My Content tab of the content page, click New item.
  3. Click Your device to choose the file from your device or drag your file into the drop zone.
  4. If you uploaded a .zip file, choose the contents of the file from the Item type drop-down menu, for example, map template or code sample.
  5. If you uploaded a code sample (.zip), choose the language of the sample, for example, Java or C++.
  6. If necessary, choose to add the file and create a hosted feature layer, or add the file only.
  7. Click Next.
  8. Type a title.
  9. Choose a folder in My Content where you want to save the item.
  10. If your organization has set up content categories, click Assign categories and select up to 20 categories to help people find your item. You can also start typing a category name to narrow the list of categories.
  11. Optionally, type tag terms separated by commas.

    Tags are words or short phrases that describe your item and help people find your item when searching. Federal land is considered one tag, while Federal,land is considered two tags.

  12. Optionally, add a summary for the item.
  13. Click Save.

Once you've added your file, it appears in your content and you can edit the item details and share it (if you have sharing privileges).

Note:

The following file types require an organizational account to add to the website: Image (.jpg, .jpeg, .png, .tif, .tiff), iWork Keynote (.key), iWork Numbers (.numbers), iWork Pages (.pages), Microsoft Excel (.xls, .xlsx), Microsoft PowerPoint (.ppt, .pptx), Microsoft Word (.doc, .docx), PDF (.pdf), and Microsoft Visio Document (.vsd).

Add items from the web

When you add an item from the web, you are referencing the REST endpoint (URL). The website does not store the item itself. You can reference ArcGIS Server web services, KML, and OGC WFS, WMS, and WMTS. You can also reference documents and images stored on the web.

  1. Verify that you are signed in and have privileges to create content.
  2. From the My Content tab of the content page, click New item and click URL.
  3. Type the REST URL of the service or document, for example, https://myserver.com/arcgis/rest/services/folder/service/MapServer.

    Tip:

    If you need to access your services over HTTPS, be sure the URL you provide when you add the service starts with https.

    To find the REST URL of an ArcGIS Server service, open the Services Directory page, https://myserver.com/arcgis/rest/services, and browse to the service you want to share. You can then copy the URL from the browser's address bar. Do not append any parameters, such as a token, to the URL.

  4. Verify that the item type is correct. If the type is different than the one selected, choose the correct type of item:
  5. If you added a secure service that is available externally, choose whether or not you want the credentials stored with the service item. If the credentials are not stored with the item, everyone who accesses the item will be prompted for credentials every time they access the service item. If the credentials are stored with the item, you will not be prompted for credentials.
  6. Click Next.
  7. If you added a secure service that is available externally, enter a user name and password for an account that has access to the service.

    User names might be case sensitive depending on how your identity systems are managed. If you store the credentials and plan to share the service in a public app, you may want to enable rate limiting to limit use on the service.

    Note:

    If you do not see the user name and password fields or the options to store or not store credentials, or if you see an error when attempting to add the secure service, there may be an issue with your HTTPS configuration. The ArcGIS Server site providing the service for which you are attempting to store credentials must support HTTPS and have a valid certificate signed from a well-known certificate authority. For additional troubleshooting, contact Esri Support.

  8. If you added a WMS (OGC) layer, choose the layers you want to be visible.
  9. If you added a WFS (OGC) or WMTS (OGC) layer, select the layer that will be drawn when the item is added to a map. If you want to add multiple layers from a WFS or WMTS service, you must create individual items for each layer.

    If the WMTS service supports multiple projections, you must select a specific projection. By default, the first projection available is selected.

  10. Click Next.
  11. Type a title.
  12. Choose a folder in My Content where you want to save the item.
  13. If your organization has set up content categories, click Assign categories and select up to 20 categories to help people find your item. You can also start typing a category name to narrow the list of categories.
  14. Optionally, type tag terms separated by commas.

    Tags are words or short phrases that describe your item and help people find your item when searching. Federal land is considered one tag, while Federal,land is considered two tags.

  15. Optionally, add a summary for the item.
  16. Click Save.

Once you've added your item from the web, it appears in your content and you can edit the item details and share it (if you have sharing privileges).

Add and publish files from a cloud drive

Sign in to your account on Google Drive, Dropbox, or Microsoft OneDrive to access comma-separated values (CSV) files, Microsoft Excel files, GeoJSON files, shapefiles, or file geodatabases to publish as a hosted feature layer. Shapefiles and file geodatabases must be compressed in a .zip file. You can also publish a Google Sheet from your Google Drive.

  1. Verify that you are signed in and have privileges to publish hosted feature layers.
  2. From the My Content tab of the content page, click New item.
  3. Click the cloud provider where your file is stored.
  4. Sign in to your account for this cloud provider.
  5. Search for or browse to the file you want to publish.

    All searches use the search capability made available by the specific cloud provider.

  6. Click the file you want to publish.
  7. Choose to add the file and publish it as a hosted feature layer or add the file only.
  8. Click Next.
  9. Review the included fields. You can remove fields, change the display name of the field, and change the field type. If the field types can be identified, they are set automatically.
  10. Choose a Time Zone for the date fields in the file.

    By default, date fields are assumed to contain UTC date and time. If your date fields store values that use a different time zone, choose that time zone. Note that the time zone you select is applied to all date fields in the file. If you later overwrite the hosted feature layer using updated data, the time zone specified when you initially published is used.

  11. Click Next.
  12. Choose the information in your file that ArcGIS Online should use to locate features.
    • If your file contains coordinates, choose whether to use Latitude and longitude, Military Grid Reference System (MGRS), or United States National Grid coordinates.
    • Choose Addresses or place names if your file contains place-names—for example, Westminster Abbey or Panama Canal—or addresses. By default, ArcGIS Online locates addresses based on your organization's region.
    • If you want to create a nonspatial table layer, choose None.
  13. If you are locating features based on Addresses or place names and your organization has multiple locators configured, click Advanced location settings and choose the locator you want to use.
  14. If your file contains addresses, click Advanced location settings and use the Region drop-down list to specify the country in which the addresses are located. If your file contains addresses from multiple countries or from a country not in the list, select World.
  15. Choose whether your location fields are based on one or multiple fields.
  16. Review the location fields (if any exist). If ArcGIS Online can identify which fields contain location information, it sets them automatically. However, you can change location fields if necessary by using the drop-down menu.
  17. Click Next.
  18. Type a title.
  19. Choose a folder in My Content where you want to save the item.
  20. If your organization has set up content categories, click Assign categories and select up to 20 categories to help people find the hosted feature layer you're publishing. You can also start typing a category name to narrow the list of categories.
  21. Optionally, type tag terms separated by commas.

    Tags are words or short phrases that describe your item and help people find your item when searching. Federal land is considered one tag, while Federal,land is considered two tags.

  22. Optionally, type a summary that describes the data.
  23. Click Save.

The feature layer is added to My Content, but the file stays on the cloud drive. If you update the source file on the cloud drive, you can overwrite the content in the hosted feature layer.

To test the new hosted feature layer once publishing completes, open it in Map Viewer (formerly known as Map Viewer Beta) or Map Viewer Classic (formerly known as Map Viewer).

By default, only you and the administrator can access the hosted feature layer. To allow others to access it, share the layer with everyone (the public), your organization, or members of specific groups. You can edit item details and change feature layer settings.

If you want to share the hosted feature layer as a copy in a distributed collaboration, you must enable synchronization.

Add apps

Adding a URL reference to an existing app is an effective way to share your work with members of your organization and the general public (depending on your sharing privileges). In addition to the URL, you can share other details such as the type of app, its purpose, a summary and description, and a .zip file with the code you used to create the app. As an app developer with an organizational account, you can also register your app with the platform.

Adding an app to ArcGIS Online only adds a reference to your URL; the website does not store the app files.

Tip:

Another way to share apps with members of your organization and the general public is to create apps with maps and gallery apps with groups.

  1. Verify that you are signed in and have privileges to create content.
  2. From the My Content tab of the content page, click New item and click Application.
  3. Choose the type of app:
    • Web Mapping—A web app built with a web API, such as JavaScript.
    • Desktop—An app for desktops built on a desktop platform, such as Java or .NET (Microsoft Windows Desktop).
    • Mobile—A downloadable app built for mobile devices with an SDK, such as iOS or Android.
    • Other application—A desktop application or any type of generic app where you don't have details about purpose, API/SDK, or URL address.
  4. For web mapping, desktop, or mobile, type the URL of the app, for example, https://<myServer>/myWebMapApp.
  5. For desktop apps, click Browse and choose the .zip file that contains your app.
  6. Click Next.
  7. Type a title.
  8. Choose a folder in My Content where you want to save the item.
  9. If your organization has set up content categories, click Assign categories and select up to 20 categories to help people find your item. You can also start typing a category name to narrow the list of categories.
  10. Optionally, type tag terms separated by commas.

    Tags are words or short phrases that describe your item and help people find your item when searching. Federal land is considered one tag, while Federal,land is considered two tags.

  11. Optionally, add a summary for the item.
  12. Click Save.

Once you've added your app, it appears in your content and you can edit the item details (where you can attach code if you want) and share it (if you have sharing privileges).

Register your app

As a developer with an organizational account, you can register your app with the platform to generate an app ID. Use the app ID in your app to collect usage statistics and to allow users to sign in to the platform with OAuth 2.0, a standardized authorization framework. With OAuth 2.0, apps guide the user to sign in to the platform through a platform-hosted login page. It also allows your app to work with user content associated with their organization as well as work with other ArcGIS Online capabilities such as geocoding, routing, and GeoEnrichment. To learn more about authentication and OAuth 2.0, see ArcGIS Developer.

Before you can register your app, you need to add it to ArcGIS Online. See the section above for details. After you've added it, follow the steps below to register your app and get an app ID and app secret. If you've added a generic type of app, the app is automatically registered.

Note:

The implementation pattern for user logins differs slightly depending whether you are developing a web-based app or a native app. ArcGIS Developer documentation has details and code samples for both web-based apps and native apps.

  1. Verify that you are signed in with an organizational account and have privileges to create content.
  2. From the My Content tab of the content page, click the title of the app you want to register to view its item page.
  3. Click the Settings tab. Scroll down to the App Registration section and click Register.
  4. Select the type of app: browser, native, server, or multiple.
  5. For each redirect URI, enter the address in the format ["https://<server>[:port]"] and click Add.

    Redirect URIs are valid addresses that users of your app can be redirected to after they successfully sign in.

  6. To remove a URI you previously added, select it, click Delete, and click Register.

View and update app registration information

Once you've registered your app, you can view registration information—which includes an app ID and an app secret—update the redirect URIs, and reset the secret. You can also view usage information about who has signed in to the app and the number of credits they've consumed and unregister the app.

Note:

Resetting the app secret will invalidate all existing user and app tokens issued for the app. Users will need to sign in to the app again, and apps configured with the secret may need to be updated.

  1. Verify that you are signed in to your organizational account and click the My Content tab of the content page.
  2. Click the title of the registered app.
  3. On the item page, click the Settings tab.
  4. Scroll down to the Application Settings section and click Registered Info.

    You can view the following details: app ID, app secret, app type, and redirect URIs.

  5. To update the redirect URIs, click Update and follow these steps:
    1. To add a redirect URI, enter the address and click Add.
    2. To remove a redirect URl, select the URI address and click Delete.
    3. Click Update and click Save.
  6. To reset the app secret, click Update and follow these steps:
    1. Click Reset Secret.

      Resetting the app secret will invalidate all existing user and app tokens issued for this app. Users will need to sign in to the app again, and apps configured with the secret may need to be updated.

    2. Click Yes if you are sure you want to reset the app secret.
    3. Click Update and click Save.
  7. To view usage information about who has signed in to your app or the number credits they've consumed, click Application Usage and choose to show credits or users and choose the time period.
  8. To unregister your app, click Unregister App.

    Your app is no longer registered. You do not need to save the item page.