You can publish feature layers from any of the following to be hosted on your ArcGIS Enterprise portal:
- Comma-separated values (CSV) files
- Microsoft Excel files (.xlsx or .xls)
- GeoJSON files or zipped shapefiles
- Feature collections
- Zipped file geodatabases
- ArcGIS Pro maps
- ArcMap documents
Feature layers are useful when you need to expose vector data for display, query, and editing to other members of your organization or when you want to share a table of nonspatial attributes. Hosting a feature layer on ArcGIS Enterprise is one 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.
To complete the steps in the following sections, you must have privileges to publish hosted feature layers and create content.
Publish a CSV file
You can log in to the portal website and publish features or tables 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 or tables from the portal website using a CSV file. Features are published in the WGS 1984 Web Mercator (Auxiliary Sphere) coordinate system.
The following steps explain how to add a CSV file from your local drive and publish. For instructions on accessing and publishing a file from a cloud drive, see Add items.
- Verify that you are signed in and that you have privileges to create content and publish hosted feature layers.
- Open Content > My Content, click Add Item, and click From my computer.
- Click Choose File or Browse (the button name varies by web browser) and find the file on your computer.
- Select the file and click Open.
- Type a title.
- If your portal administrator configured content categories, click Assign Category and select up to 20 categories to help people find your item. You can also use the Filter categories box to narrow down the list of categories.
Categories are available beginning with ArcGIS Enterprise 10.6.1.
- 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 Publish this file as a hosted layer check box.
If you leave the box unchecked, your data file is added to My Content, but no hosted feature layer is published. You can, however, publish the file later. See Add items for more information.
- Choose which information in your file to use to locate features.
- Choose Coordinates if your file contains latitude/longitude coordinates.
- Choose Addresses or Places if your file contains place names--for example, Westminster Abbey or Panama Canal--or addresses.
- If you want to create a nonspatial table layer, choose None, add as table.
- If you are locating features based on Addresses or Places and your organization has multiple locators configured, choose which locator to use.
Note:
Your portal must be configured to use a locator (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.
- From the In drop-down list, choose the country where the addresses or places in your file are located . If your file contains addresses from multiple countries or from a country not in the list, select World.
- Review the field types and location fields (if any exist). If the portal can identify which fields contain location information, location fields are automatically set. Field types are also set automatically. However, you can change either of these if necessary by clicking inside the cell.
- Click a Field Type cell to choose a different type.
Note:
Date field types are not supported in ArcGIS Enterprise portals. Date fields are published as text fields.
- Click a Location Field cell to choose a different field.
- Click a Field Type cell to choose a different type.
- Choose a Time Zone for the date fields in your CSV 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 CSV file. If you later overwrite the hosted feature layer using updated data, the time zone specified when you initially published is used.
See CSV, TXT, and GPX files for information on time zone considerations and supported date and time formats.
Tip:
You can configure pop-ups to display time.
- Click Add Item.
If there is spatial information in the CSV file, it must be in address format or latitude-longitude coordinates in decimal degrees. CSV files must be formatted and saved as .csv.
The data file and the feature layer are separately added to My Content. One way to test the new hosted feature layer once publishing completes is to view it in Map Viewer.
If you published a CSV file containing addresses, you can review and correct any records that were not placed on the map or were placed incorrectly. You can immediately review the locations in Map Viewer, or choose to review them at a later time. See Review locations for more information.
By default, only you and the administrator can access the hosted feature layer. To allow others to access it, share the layer and file 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.
Be aware that only 2,000 records are returned at a time by default when drawing or querying a feature layer. You can update this limit on existing hosted feature layers from the service properties in ArcGIS Server Manager. Connect to your hosting server and set the Maximum Number of Records Returned by Server property to the desired value for each service.
Publish an Excel file
You can upload an Excel file (.xlsx or .xls) to your portal website and publish a hosted layer from one of the worksheets. If the worksheet contains latitude and longitude information or addresses, you can publish a hosted feature layer. Features are published in the WGS 1984 Web Mercator (Auxiliary Sphere) coordinate system. If no spatial information is present in the worksheet, you can publish a table layer.
The following steps explain how to add an Excel file from your local drive and publish. For instructions on accessing and publishing a file from a cloud drive, see Add items.
- Verify that you are signed in and that you have privileges to create content and publish hosted feature layers.
- Open Content > My Content, click Add Item, and click From my computer.
- Click Choose File or Browse (the button name varies by web browser) and find the file on your computer.
- Select the file and click Open.
- Type a title.
- If your portal administrator configured content categories, click Assign Category and select up to 20 categories to help people find your item. You can also use the Filter categories box to narrow down the list of categories.
Categories are available beginning with ArcGIS Enterprise 10.6.1.
- 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 Publish this file as a hosted layer check box.
If you leave the box unchecked, your data file is added to My Content, but no hosted feature layer is published. You can, however, publish the file later. See Add items for more information.
- If your file contains multiple worksheets, choose the one you want to publish from the Publish this Excel sheet drop-down list.
By default, the first sheet in the spreadsheet is published.
- Choose which information in your file to use to locate features.
- Choose Coordinates if your file contains latitude/longitude coordinates.
- Choose Addresses or Places if your file contains place names--for example, Westminster Abbey or Panama Canal--or addresses.
- If you want to create a nonspatial table layer, choose None, add as table.
- If you are locating features based on Addresses or Places and your organization has multiple locators configured, choose which locator to use.
Note:
Your portal must be configured to use a locator (geocode utility service) that can do batch geocoding for you to publish an Excel file containing addresses. Contact your portal administrator if the option to publish is not available when you add your file.
- From the In drop-down list, choose the country where the addresses or places in your file are located . If your file contains addresses from multiple countries or from a country not in the list, select World.
- Review the location fields (if any exist). You can change them if necessary by clicking inside the cell. If the portal can identify which fields contain location information, it sets them automatically. However, you can change location fields if necessary by clicking inside the cell.
- 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.
Tip:
You can configure pop-ups to display time.
- Click Add Item.
The data file and the feature layer are separately added to My Content. One way to test the new hosted feature layer once publishing completes is to view it in Map Viewer.
If you published an Excel file containing addresses, you can review and correct any records that were not placed on the map or were placed incorrectly. You can immediately review the addresses in Map Viewer, or choose to review the addresses at a later time. See Review locations for more information.
By default, only you and the administrator can access the hosted feature layer. To allow others to access it, share the layer and file 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.
Publish a shapefile or GeoJSON file
To web enable feature layers from shapefiles (packaged in a .zip file) or GeoJSON files (.geojson or .json), add the files to your portal and publish. 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 following steps outline how to publish features from the portal website using a shapefile or GeoJSON file. The features are published in the WGS 1984 Web Mercator (Auxiliary Sphere) coordinate system.
- Verify that you are signed in and that you have privileges to create content and publish hosted feature layers.
- Open Content > My Content, click Add Item, and click From my computer.
- Click Choose File or Browse (the button name varies by web browser) and find the file on your computer.
- Select the file and click Open.
- Type a title.
- If your portal administrator configured content categories, click Assign Category and select up to 20 categories to help people find your item. You can also use the Filter categories box to narrow down the list of categories.
Categories are available beginning with ArcGIS Enterprise 10.6.1.
- 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 Publish this file as a hosted layer check box.
If you leave the box unchecked, your data file is added to My Content, but no hosted feature layer is published. You can, however, publish the file later. 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 are all included in the feature layer.
The data file and the feature layer are separately added to My Content. One way to test the new hosted feature layer once publishing completes is to view it in Map Viewer.
If you published a shapefile or shapefiles that contained metadata, that metadata is included in the layers in the hosted feature layer. When viewed from the hosted feature layer's item page, the metadata is displayed in the metadata style configured for the portal.
By default, only you and the administrator can access the hosted feature layer. To allow others to access it, share the layer and file 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.
Be aware that, by default, only 2,000 records are returned at a time when drawing or querying a feature layer. You can update this limit on existing hosted feature layers from the service properties in ArcGIS Server Manager. Connect to your hosting server and set the Maximum Number of Records Returned by Server property to the desired value for each service.
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 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.
- Use the default title for the hosted feature layer or type a new one.
- If your portal administrator configured content categories, click Assign Category and select up to 20 categories to help people find your item. You can also use the Filter categories box to narrow down the list of categories.
Categories are available beginning with ArcGIS Enterprise 10.6.1.
- 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 the contents of a file geodatabase
You can log in to the portal website and publish a feature layer 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. This 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.
You can publish the following data types from a file geodatabase to a hosted feature layer:
- Feature classes (x- and y-coordinates; m- and z-coordinates are dropped)
- Tables
- Attachments
- Relationship classes
The features are published in the WGS 1984 Web Mercator (Auxiliary Sphere) coordinate system.
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.
Hosted feature layers created from file geodatabases cannot be shared in distributed collaborations.
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 feature layers.
- Open Content > My Content, click Add Item, and click From my computer.
- Click Choose File or Browse (the button name varies by web browser), and find the file on your computer.
The file geodatabase must be in a .zip file.
- Select the file and click Open.
- Type a title.
- If your portal administrator configured content categories, click Assign Category and select up to 20 categories to help people find your item. You can also use the Filter categories box to narrow down the list of categories.
Categories are available beginning with ArcGIS Enterprise 10.6.1.
- 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 hosted layer.
If you leave the box unchecked, the file geodatabase is added to My Content, but no hosted feature layer is published. You can publish later if you want. See Add items for more information.
- 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 and publish. Once publishing completes, you can test the new feature layer by viewing it in Map Viewer.
If the feature classes in the file geodatabase contained metadata, that metadata is included in the layers in the hosted feature layer. For each layer that has metadata, you can view the metadata from the hosted feature layer's item page, and the metadata is displayed in the metadata style configured for the portal.
By default, only you and the administrator can access the hosted feature layer. To allow others to access it, share the layer and file with everyone (the public), your organization, or members of specific groups. You can edit item details and change feature layer settings.
Be aware that, by default, only 2,000 records are returned at a time when drawing or querying a feature layer. You can update this limit on existing hosted feature layers from the service properties in ArcGIS Server Manager. Connect to your hosting server and set the Maximum Number of Records Returned by Server property to the desired value for each service.
Publish from ArcGIS Pro
You can publish a hosted feature layer from ArcGIS Pro to your portal. When you do so, feature data is copied from your source to the relational data store registered with your portal's hosting server.
Note:
If the layers in ArcGIS Pro have definition queries applied to them, ArcGIS applies the definition queries to the published hosted feature layer. However, all data is copied to ArcGIS Enterprise. If you want to publish a subset of the data, you must export the subset to another feature class and publish that.
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.
Tip:
- Web browsers cannot display some of the more complex cartographic symbols used when authoring the map in ArcMap. Most symbol types are available, but some symbols may be downgraded when you publish them. See Author feature services in the ArcGIS Server help for more details about what symbols are supported. Make any required changes to your map symbology prior to publishing.
- To reproject the data used by the hosted feature layer, apply a geographic transformation to the data when publishing.
- Start ArcGIS Pro and open the project that contains the map or scene with the data you want to publish.
- Be sure your portal connection is active in the project and that you are signed in to the portal using an account that has privileges to create content and publish hosted feature layers.
- To publish a hosted 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.
To publish all the layers in the map, click Web Layer in the Share As group of the Share tab and click Publish Web Layer.
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.
- Type a name for the feature layer. The layer is saved to My Content by default. You can save to a subfolder in My Content by either typing the folder name or browsing to an existing folder.
- Choose to Copy all data.
- For Layer Type, check Feature.
This automatically unchecks other Layer Type options, as only one can be checked at a time when copying data.
- Provide a summary and tags for the feature layer.
- Specify who can access the hosted feature layer. By default, all layers you publish are shared only 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:
- Your organization—Selecting the organization allows all authenticated users in the organization to access the layer.
- 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, editing is not enabled on the feature layer, it cannot be taken offline, and the data it contains cannot be exported by other users. To allow others to perform these operations on your feature layer, click the Configuration tab, click the Configure Layers button , click the Configure Web Layer Properties button , 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. It also allows you to share the hosted feature layer in a distributed collaboration.
- Export Data—Enabling this operation allows other members to export data from the hosted feature layer. The hosted feature layer owner and organization administrator can always export data from a hosted feature layer.
- Under Properties, you can choose to insert a default number for z-values and replace m-values with NaN values.
Caution:
Only insert default z-values or replace m-values with NaN values if you do not need the existing values, as the default or NaN value is inserted for any feature whose geometry you edit using a client that does not let you provide a value for those properties, such as in Map Viewer.
- Click the back arrow to close the Feature Properties pane.
- By default, no more than 2,000 features are returned to clients that query your hosted feature layer. If you want to decrease or increase the number of features returned, click the Configure Parameters button on the Configuration tab and type a different number in the Maximum records returned by server field.
Increasing the maximum features returned can negatively affect query performance.
- Click the Content tab to confirm your feature layer includes the data layers you intended.
- Click Analyze to check for any errors or issues.
If any issues are discovered, they are listed on 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. You have the option to fix the warnings to further improve the performance and appearance of your hosted feature layer.
Tip:
If you open the Share Web Layer dialog box from the Share ribbon, you receive a warning that the layer's data source is not supported. This usually refers to the basemap layer, which cannot be published.
- Once you've fixed the errors and, optionally, any warnings, click Publish.
Note:
Your data is copied to the hosting server's relational data store at this point. The size of the data and your network speed and bandwidth affect the time it takes to publish.
When publishing completes, you can click Manage the web layer to open the portal website.
Beginning with ArcGIS Pro 2.2, metadata that you defined on the feature classes in the map is included in the layers in the hosted feature layer. For each layer that has metadata, you can view the metadata from the portal, and the metadata is displayed in the metadata style configured for the portal.
Publish from ArcMap
From ArcMap, you can publish a feature layer to be hosted on your portal. When you publish a hosted feature layer, data is copied from you data source to the relational data store registered with your portal's hosting server.
Note:
If the layers in ArcMap have definition queries applied to them, ArcGIS applies the definition queries to the published hosted feature layer. However, all data is copied to ArcGIS Enterprise. If you want to publish a subset of the data, you must export the subset to another feature class and publish that.
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 enable editing on the hosted feature layer after publishing.
Before proceeding, be sure ArcMap is connected to your ArcGIS Enterprise portal.
Metadata included in your map document is included with the hosted feature layer you publish to your portal.
Tip:
Web browsers cannot display some of the more complex cartographic symbols used when authoring the map in ArcMap. Most symbol types are available, but some symbols may be downgraded when you publish them. See Author feature services in the ArcGIS Server help for more details about what symbols are supported. Make any required changes to your map symbology prior to publishing.
- Start ArcMap and open the map you want to publish.
Be sure the layers in the map you publish do not have their display expression set to the area or length field.
- Click File > Sign In.
- Type your name and password for your ArcGIS Enterprise organization 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 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 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 Set 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 accessible only to you and portal administrators. You can share it with everyone, members of your organization, or 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 Analyze 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 hosting server's relational data store at this point. The size of the data and your network speed and bandwidth affect 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. Connect to your hosting server and set the Maximum Number of Records Returned by Server property to the desired value for each service.
If you want to share the hosted feature layer as a copy in a distributed collaboration, you must enable synchronization.
Create from a template or existing feature layer
The website allows you to create a hosted feature layer that does not contain data if your portal's hosting server is using a relational data store created through 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.
Follow these steps to create a hosted feature layer from a template or another feature layer.
- Verify that you are signed in with an account that has privileges to create content and publish hosted feature layers, and open the My Content tab of the content page.
- Click Create and choose Feature Layer.
- Choose an existing feature layer that contains the layers and schema you want to apply to the new feature layer. This step doesn't add or copy any features to your new hosted feature layer; you're only defining the layers and schema of the new hosted feature layer.
There are several approaches you can take:
- Click the From Template tab, select one of the template feature layers provided by Esri, and click Create.
- Click the Existing Layer tab to use a hosted feature layer from your organization. Search for or browse to the existing feature layer you want to use, select it, and click Create.
- Click the From URL tab, type the URL of an existing feature layer, and click Next.
No matter which approach you take, check the box next to each layer you want to include in your new feature layer. You must choose at least one layer.
Click Capture GPS receiver information to add GPS metadata fields to point layers and store GPS information such as receiver name, accuracy, and fix type. When you edit the layer in Collector for ArcGIS, GPS metadata is recorded automatically. For more information about GPS metadata, see Record GPS metadata in the Collector for ArcGIS help.
When you finish choosing layers, click Next.
- Define the default extent you want for your new feature layer by panning and zooming on the map presented on the New Hosted Feature Layer dialog box, or type the latitude and longitude coordinates. When you finish, click Next.
This step helps you narrow the scope of the layer when it is first edited.
- Type a title, tags, and summary for the new hosted feature layer.
- If your portal administrator configured content categories, click Assign Category and select up to 20 categories to help people find your item. You can also use the Filter categories box to narrow down the list of categories.
Categories are available beginning with ArcGIS Enterprise 10.6.1.
- Choose in which folder to store the new hosted feature layer. Click Done to publish the new layer.
The item details page of your new hosted feature layer appears.
Caution:
By default, editing is enabled on your new hosted feature layer. Disable editing if you don't want other people to edit it immediately.