Publish features
In this topic
- Publish a CSV file
Publish a shapefile - Publish a feature collection
- Publish from ArcMap
- Publish from
ArcGIS Pro - Publish the contents of a file geodatabase
- Publish an empty hosted feature layer
You can publish features from comma-separated value (CSV) files, zipped shapefiles, feature collections, ArcMap documents, ArcGIS Pro maps, or zipped file geodatabases to be hosted as feature layers on your portal. You can also publish an empty feature layer so members of your organization can add features to it.
Feature layers are useful when you need to expose vector data for display, query, and editing to other members of your organization. Hosting a feature layer on Portal for ArcGIS is an easy way to share data with coworkers through maps, apps, and desktop map viewers.
Feature layers are most appropriate for operational layers that go on top of reference layers such as a basemap. For example, a feature layer might contain information about the street signs in your neighborhood. Each feature (street sign) might include the sign name, date installed, and a website URL for reporting problems to your local street department.
You must have privileges to create content and publish hosted feature layers to create an empty hosted feature layer or publish from a file or map.
Publish a CSV file
You can log in to the portal website and publish features from CSV files that you have stored on your computer. The resultant feature layer is published as a service to your portal's hosting server. These services are referred to as hosted feature layers.
The steps below outline how to publish features from the portal website using a CSV file. The features are published in the WGS 1984 Web Mercator (Auxiliary Sphere) coordinate system. Uploads over 2 GB in size are not supported and will result in an error.
- Verify that you are signed in and that you have privileges to create content and publish hosted features. If you have a large file to publish, you should check Keep me signed in when signing in. This helps prevent the website from timing out before the feature layer has been created.
- Open My Content and click Add Item.
The Add Item window opens.
- Choose On my Computer from the The item is options.
- Click the browse button, and choose the file on your computer.
- Type a title.
- 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.
- Check the box next to Publish this file as a feature layer.
If you leave the box unchecked, your data file is added to My Content but no feature layer is published. You can publish the features later if you want. See Add items for more information.
- Choose to locate the features using latitude-longitude or address.
- If you choose to locate addresses, choose the country used to geocode your addresses from the Country drop-down list. If your file contains addresses from multiple countries or from a country not in the list, select World.
Note:
Your portal must be configured to use a geocode utility service that can do batch geocoding for you to publish a CSV file containing addresses. Contact your portal administrator if the option to publish is not available when you add your file.
- Review the field types and location fields. You can change them if necessary.
- Click a Field Type cell to choose a different type.
- Click a Location Field cell to choose a different field.
- Click Add Item.
CSV files need to contain address information or latitude-longitude coordinates in decimal degrees. CSV files must be formatted and saved as .csv. Other text-based file types cannot be published.
Your file is published as a hosted feature layer. It may take some time to upload the file. One way to test the new feature layer is to view it in the map viewer.
The data file and the feature layer are separately added to My Content. You can edit item details and share the items. The items are independent, so for example, if you change the thumbnail in the feature layer's item details, the thumbnail does not update on the file's item details.
By default, the hosted feature layer can only be accessed by the publisher. You can share the hosted feature layer and the file with everyone in your organization or members of specific groups.
Be aware that, by default, only 2,000 records are returned at a time when drawing or querying a feature layer. You can edit the Maximum Number of Records Returned by Server property in the service's parameters in ArcGIS Server Manager to change the number of records returned.
Publish a shapefile
You can log in to the portal website and publish features from shapefiles (packaged in a .zip file) that you have stored on your computer. The resultant feature layer is published as a service to your portal's hosting server. These services are referred to as hosted feature layers.
The steps below outline how to publish features from the portal website using a shapefile. The features are published in the WGS 1984 Web Mercator (Auxiliary Sphere) coordinate system. Uploads over 2 GB in size are not supported and will result in an error.
- Verify that you are signed in and that you have privileges to create content and publish hosted features. If you have a large file to publish, you should check Keep me signed in when signing in. This helps prevent the website from timing out before the feature layer has been created.
- Open My Content and click Add Item.
The Add Item window opens.
- Choose On my Computer from the The item is options.
- Click the browse button and choose the file on your computer.
- Choose Shapefile from the Contents drop-down list.
- Type a title.
- 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.
- Check the box next to Publish this file as a feature layer.
If you leave the box unchecked, your data file is added to My Content but no feature layer is published. You can publish the features later if you want. See Add items for more information.
- Click Add Item.
Shapefiles must be compressed as a .zip file containing .shp, .shx, .dbf, and .prj files.
If there are multiple shapefiles in the .zip file, they will all be included in the feature layer.
Your file is published as a hosted feature layer. It may take some time to upload the file. One way to test the new feature layer is to view it in the map viewer.
The data file and the feature layer are separately added to My Content. You can edit item details and share the items. The items are independent, so for example, if you change the thumbnail in the feature layer's item details, the thumbnail does not update on the file's item details.
By default, the hosted feature layer can only be accessed by the publisher. You can share the hosted feature layer and the file with everyone in your organization or members of specific groups.
Be aware that, by default, only 2,000 records are returned at a time when drawing or querying a feature layer. You can edit the Maximum Number of Records Returned by Server property in the service's parameters in ArcGIS Server Manager to change the number of records returned.
Publish a feature collection
If your data needs to be edited by multiple people, you can publish your feature collection as a hosted feature layer, share the layer, enable editing on it, and then use the feature layer in your map.
Note:
If you alter symbology for individual points in the feature collection, that symbology change is not preserved when you publish the feature collection as a hosted feature layer.
- Open the item details of the feature collection you want to publish as a hosted feature layer.
- Click Publish.
- You can use the default title for the hosted feature layer or type a new one.
- Type tag terms separated by commas.
Tags are words or short phrases that describe your item and help people find your item when searching. public buildings is considered one tag, while public,buildings is considered two tags.
- Click Publish to create the hosted feature layer.
A hosted feature layer is created and added to your content.
Now you can share the hosted layer, enable editing, and add the feature layer to your map.
Publish from ArcMap
From ArcMap, you can publish a feature layer to be hosted on your portal. The hosted feature layer will expose all vector datasets included in the map document.
Before proceeding, be sure ArcGIS for Desktop is connected to your portal.
By default, editing is not enabled on hosted feature layers. You can enable editing from ArcMap when you initially publish or overwrite an existing feature layer. Alternatively, you can edit the feature layer properties in the portal website to allow editing.
Caution:
If you overwrite a hosted feature layer by republishing from ArcMap, the existing feature layer item is deleted from the portal, a new item is created with the same name, but the item is created in the root folder and is assigned a new ID. You will need to reconfigure sharing and, if necessary, move the item back to the folder it was in before you republished. You will also have to reconfigure any pop-ups or symbology you previously saved on the item.
Also note that web browsers cannot display some of the more complex cartographic symbols you might have originally used when you authored the map in ArcMap. Most symbol types are available, but in some cases the symbols may be downgraded when you publish them. See Authoring feature services in the ArcGIS for Server Help for more details about what symbols are supported and make any required changes to your map symbology prior to publishing.
- Start ArcMap and open the map you want to publish.
- Click File > Sign In.
- Type your name and password for your portal and click Sign In.
- Click File > Share As > Service.
- Choose Publish a service and click Next.
- In the drop-down list of connection types, choose My Hosted Services. Type a name for your feature layer and click Continue.
- In the left pane of the Service Editor, click Capabilities and check Feature Access to expose your map as a feature layer. You can optionally also check Tiled Mapping, although in most scenarios, you would use a different set of layers and a different map document for publishing a tile layer.
You can click the subitem Feature Access in the left pane of the Service Editor to set advanced properties relating to what clients can do with the hosted feature layer. To learn how to adjust the types of edits that end users can make to your hosted feature layer, see Editor permissions for feature services.
- Set other properties that you want for your hosted feature layer. You can choose what users can do with your feature layer and take fine-grained control of how the server will expose it.
For information on how to best configure your hosted feature layer for deployment, see Tuning and configuring services. Some of the properties referenced in that topic apply only to ArcGIS for Server and are not applicable when working with feature layers hosted on your portal.
Tip:
If you close the Service Editor during this session, you'll be prompted to save your work as a draft service. Draft services allow you to come back to your service configuration work at a later time. By default, draft services are saved in the Drafts folder of your connection to My Hosted Services. For more information, see About draft services.
- In the left pane of the Service Editor, click Item Description and enter a summary and tags for your layer. You'll need to enter this information before you can publish. For more information, see Setting map service properties.
- In the left pane of the Service Editor, click Sharing and choose with whom the feature layer should be shared. By default, your hosted feature layer is shared to My Content only, meaning it is only accessible to you. Your hosted feature layer will always be visible in My Content, but you can also choose to share it with everyone, members of your organization, or just members of certain groups.
- In the Service Editor, click
Analyze. This examines your map to see if it can be published. You must fix the Errors
in the Prepare window before you can publish. Optionally, you can fix the warnings and informational messages to further improve the performance and appearance of your hosted feature layer. For more information about resolving these issues, see Analyzing your GIS resource. - Optionally, in the Service Editor, click
Preview. This can give you an idea of how your feature layer will look when viewed on the web. - Once you've fixed the errors and optionally any warnings and messages, click
Publish.Note:
Your data is copied to the server at this point. The size of the data and your network speed and bandwidth will impact the time it takes to publish.
Once your feature layer is published and hosted on your portal, you'll see it when you expand the My Hosted Services node in the Catalog window.
By default, feature layers published from an ArcMap document only return 1,000 records. This limit is configurable in the publisher dialog box when publishing a new feature layer or overwriting an existing hosted feature layer. You can also update this limit on existing hosted feature layers from the service properties in ArcGIS Server Manager. Set the Maximum Number of Records Returned by Server property to the desired value.
Publish from ArcGIS Pro
From ArcGIS Pro, you can publish a feature layer to be hosted on your portal.
Before proceeding, be sure your organization connection is active.
By default, editing is not enabled on hosted feature layers, but you can enable editing from ArcGIS Pro when you initially publish or overwrite an existing feature layer. Alternatively, you can edit the feature layer properties in the portal website to allow editing.
Caution:
If you overwrite a hosted feature layer, the existing feature layer item is deleted from the portal, a new item is created with the same name, but the item is created in the root folder and is assigned a new ID. You will need to reconfigure sharing and, if necessary, move the item back to the folder it was in before you republished. You will also have to reconfigure any pop-ups or symbology you previously saved on the item.
Also note that web browsers cannot display some of the more complex cartographic symbols you might have originally used when you authored the map. Most symbol types are available, but in some cases the symbols may be downgraded when you publish them. See Authoring feature services in the ArcGIS for Server Help for more details about what symbols are supported and make any required changes to your map symbology prior to publishing.
- Start ArcGIS Pro and open the project that contains the map or scene with the data you want to publish.
- Sign in to your organization from ArcGIS Pro.
- To publish a feature layer, do one of the following:
- Select the layers in the Contents pane. Right-click the selection set and click Share As Web Layer. When you publish selected layers, only a hosted feature layer is created on your portal.
Tip:
If the Share As Web Layer menu option is not active, it could be due to one of the following:
- The account you signed in with does not have privileges to publish hosted feature layers.
- Your portal is not configured with a hosting server, which is required to host web layers.
- You're trying to publish a multipatch layer, which is not supported.
To share the map and publish all of its layers, click Web Map in the Share As group of the Share tab. When you share a map using ArcGIS Pro, the map layers are also published as hosted layers.
- Select the layers in the Contents pane. Right-click the selection set and click Share As Web Layer. When you publish selected layers, only a hosted feature layer is created on your portal.
- Type a name for the feature layer. The layer is saved to My Content by default. You can save to a folder within My Content by either typing the folder name or browsing to an existing folder.
- Accept the default Layer Type option of Features.
- Provide a summary and tags for the feature layer.
- Specify how the feature layer will be shared. All layers you publish are automatically shared to your personal workspace in your organization (My Content). Your content is inaccessible to others until you share it with one or more of the following:
- My Organization— Selecting this option allows the layer to be shared with all authenticated users in the organization.
- Everyone—Selecting this option makes the layer available to anyone who can access your portal.
- Groups—You can share the layer with members of groups to which you belong.
- By default, the feature layer you publish is not editable, cannot be taken offline, and the data it contains cannot be exported. To allow others to perform these operations on your feature layer, click the Configuration tab and check the box next to the operations you want to allow:
- Enable Editing—This operation enables anyone who can access the hosted feature layer to add, update, or delete features.
- Enable Sync—This allows people to download maps containing the hosted feature layer, edit the data, and synchronize their changes back to the hosted feature layer.
- Export Data—The hosted feature layer owner and organization administrator can always export data from a hosted feature layer. If your portal uses ArcGIS Data Store, enabling this operation allows other members to export data from the hosted feature layer to a CSV, shapefile, or file geodatabase.
- Click the Content tab to confirm your feature layer will include the data layers you intended.
- Click Analyze to check for any errors or issues.
If any issues are discovered, they will be listed in the Messages tab. Right-click each message to get more information, read help for the error or warning, and access suggested fixes. You must fix the errors before you can publish. Optionally, you can fix the warnings to further improve the performance and appearance of your hosted feature layer.
- Once you've fixed the errors and optionally any warnings, click Publish.
Note:
Your data is copied to the server at this point. The size of the data and your network speed and bandwidth will impact the time it takes to publish.
When publishing completes, you can click Manage the web layer to open the portal website.
Publish the contents of a file geodatabase
You can log in to the portal website and publish features from a file geodatabase (packaged in a .zip file) that you have stored on your computer. The resultant feature layer is published as a service to your portal's hosting server. The service is referred to as a hosted feature layer.
Publishing file geodatabase contents is a useful workflow if the geodatabase contains only a few datasets.
The following data types will publish to the hosted feature layer from a file geodatabase:
- Feature classes (x- and y-coordinates; m- and z-coordinates will be dropped.)
- Tables
- Attachments
- Relationship classes
Other data types—such as rasters, networks, and parcel fabrics—remain in the geodatabase but are not included in the published hosted feature layer. Domains also remain in the geodatabase, but are not accessible from the hosted feature layer.
Follow these steps to add a file geodatabase to your portal and publish its contents as a hosted feature layer.
- Verify that you are signed in and that you have privileges to create content and publish hosted features.
- Open My Content and click Add Item.
The Add Item window opens.
- Choose On my Computer from the The item is options.
- Click the browse button and choose the file on
your computer.
The file geodatabase must be in a .zip file.
- Choose File Geodatabase from the Contents drop-down list.
- Check the box next to Publish this file as a feature layer.
If you leave the box unchecked, the file geodatabase is added to My Content but no feature layer is published. You can publish the features later if you want. See Add items for more information.
- Type a title.
- Type tag terms separated by commas.
Tags are words or short phrases that describe your item and help people find the item when searching. Federal land is considered one tag, while Federal,land is considered two tags.
- Click Add Item.
The supported data in your file geodatabase is published as a hosted feature layer. It may take some time to upload the file. One way to test the new feature layer is to view it in the map viewer.
The data file and the feature layer are separately added to My Content. You can edit item details and share the items. The items are independent, so for example, if you change the thumbnail in the feature layer's item details, the thumbnail does not update on the file's item details.
By default, the hosted feature layer can only be accessed by the publisher. You can share the hosted feature layer and the file with everyone in your organization or members of specific groups.
Be aware that, by default, only 2,000 records are returned at a time when drawing or querying a feature layer. You can edit the Maximum Number of Records Returned by Server property in the service's parameters in ArcGIS Server Manager to change the number of records returned.
Publish an empty hosted feature layer
The website allows you to create a hosted feature layer that is empty and available for editing if your portal's hosting server is using ArcGIS Data Store. You can configure this feature layer to use the extent and schema of an existing feature layer. For example, you might have a feature layer displaying the perimeter of an existing wildfire. When a new wildfire occurs, you can create an empty feature layer from your existing one. You can then populate the new layer with the boundary and attributes of your new wildfire.
Note:
The ability to publish empty hosted feature layers was added at Portal for ArcGIS 10.3.1.
Follow these steps to create an empty hosted feature layer.
- Verify that you are signed in with an account that has privileges to create content and publish hosted features and open My Content.
- Click Create and choose Feature Layer.
- Choose an existing feature layer whose layers you would like to apply to the new feature layer. There are several approaches you can take:
- Choose Create feature layer from: an existing feature layer and select one of your feature layers from the drop-down list. By default, the list only contains items from My Content. Check Include items in my organization to display all feature layers from your organization.
- Choose Create feature layer from: an existing feature layer and type the URL of an existing hosted feature layer.
- Choose Create feature layer from: a template and select one of the template feature layers provided by Esri.
No matter which approach you take, you must choose which layers should be included in the new feature layer. Check the box next to each layer you want to include.
This step doesn't actually add or copy any features to your new hosted feature layer; you're just defining the layers (and associated attribute fields) that will be available.
When you're done choosing the layers, click Next.
- Pan the test map to the default extent you want for your new feature layer and click Next.
This step helps you narrow the scope of the layer when it is first edited.
- Type a title, tags, summary, and location for your feature layer, and click Done. You're taken to the item details page of your new hosted feature layer.
Caution:
By default, editing is enabled on your new hosted feature layer. If you don't want users to edit it immediately, you should disable editing.