Add items

If your account has privileges to create content, you can add files from your computer, items from the web, and apps to ArcGIS Online through My Content. You can also save maps and publish apps.

Add files from your computer

You can add supported files from your computer to the website and share them so others can download and open the files in desktop applications. When you share CSV files with everyone (public), you can use the URL that appears in the item details 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 in the item details page.

  1. Verify that you are signed in and have privileges to create content.
  2. From My Content, click Add Item and click From my computer.
  3. Click the browse button and choose the file on your computer.
  4. If you uploaded a .zip file, choose the contents of the file, 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. Type a title.
  7. Type tags that describe your item. Separate terms with commas (for example, Federal land is considered one tag; Federal, land is considered two tags).
  8. Click Add Item.

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

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 WMS. 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 My Content, click Add Item, and click From the web.
  3. Choose the type of item:
    • ArcGIS Server web service
    • KML
    • OGC WMS
    • Document—Documents include spreadsheets, presentations, tables, images, and other documents stored on the web. You need an organizational account to add web documents to the site.
  4. Type the REST URL of the service or document, for example, http://gisserver:6080/arcgis/rest/services/folder/service/MapServer.

    If you need to access your service over HTTPS, add your layer with https.

    To find the REST URL of an ArcGIS Server service, open the Services Directory page, http://gisserver:6080/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.

  5. 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, and select whether or not you want the credentials stored with the service item. User names might be case sensitive depending on how your identity systems are managed. If the credentials are not stored with the item, you will be prompted for credentials every time you access the service. If the credentials are stored with the item, you will not be prompted for credentials. If you store the credentials and plan to share the service in a public app, you may want to enable rate limiting to limit usage on the service.
  6. If you added an OGC WMS, choose the layers you want to be visible.
  7. Type a title.
  8. Type tags that describe your item. Separate terms with commas (for example, Federal land is considered one tag; Federal, land is considered two tags).
  9. Click Add Item.

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

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 actually store the app files.

  1. Verify that you are signed in and have privileges to create content.
  2. From My Content, click Add Item and click An application.
  3. Choose the type of app:
    • Web Mapping—A web app built with a web API such as JavaScript.
    • Mobile—A downloadable app for devices built with an SDK such as iOS.
    • Application—A desktop application or any type of generic app where you don't have details about purpose, API/SDK, or URL address.
    • Application Extension (Operations Dashboard)—An operations dashboard extension. Only default administrators can add operations dashboard extensions to ArcGIS Online.
  4. For web mapping or mobile, choose the purpose of the app:
    • Ready to Use—Fully functioning website or mobile app.
    • Configurable—Fully functioning app that can be deployed by configuring a file.
    • Self-configurable—Fully functioning app that can be deployed by using an internal app builder. This option enables the Configure App button in item details.
    • Code Sample—Code for a specific piece of functionality, either as a live sample or a description of how to use the sample in an app.
  5. For web mapping or mobile, choose the API (web mapping) or SDK (mobile) used to create the app.
  6. For web mapping, mobile, or application extension, type the URL of the app, for example, http://<myServer>/myWebMapApp.
  7. Type a title.
  8. Type tags that describe your item. Separate terms with commas (for example, Federal land is considered one tag; Federal, land is considered two tags).
  9. Click Add Item.

Once you've added your app, it appears on My 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 though 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 for Developers.

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.

  1. Verify that you are signed in with an organizational account and have privileges to create content.
  2. Click My Content and click the title of the app you want to register to view its item details.
  3. Scroll down to the App Registration section and click Register.

    If you've added a generic type of app, the app is automatically registered and you see the Registered Info button instead of the Register button. You can view and update the registration information.

  4. Select the type of app: browser, native, server, or multiple.
  5. For each redirect URI, enter the address in the format ["http://<server>[:port]"] and click Add.

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

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

View and update app registration info

Once you've registered your app, you can view registration info, which includes an app ID and an app secret. You can also update the redirect URIs, reset the secret, and unregister the app.

  1. Verify that you are signed in to your organizational account and click My Content.
  2. Click the title of the registered app.
  3. Scroll down to the App Registration section and click Registered Info.

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

  4. To update the redirect URIs, follow these steps:
    1. Click Edit from the top of the item details page.
    2. Scroll down to the App Registration section and click Update. The Registered Info window opens.
    3. To add a redirect URI, enter the address and click Add.
    4. To remove a redirect URl, select the URI address and click Delete.
    5. Click Update and click Save.
  5. To reset the app secret, follow these steps:
    1. Click Edit from the top of the item details page.
    2. Scroll down to the App Registration section and click Update. The Registered Info window opens.
    3. 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.

    4. Click Yes if you are sure you want to reset the app secret.
    5. Click Update and click Save.
  6. To unregister your app, follow these steps:
    1. Click Edit from the top of the item details page.
    2. Scroll down to the App Registration section and click Unregister App.

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