Prepare data

For ArcGIS Urban to function effectively, certain data is recommended. Although you can open Urban with empty layers, you cannot run urban planning workflows without the following data:

  • Space use types
  • Zoning types
  • Land use types
  • Building types
  • Space use types
  • Project status types
  • Feedback categories

When data is processed, some data uploads are required before other data can be configured. These dependencies are as follows:

  • Zoning types is required before the zoning layer can be added.
  • Land use types is required before the land use layer can be added.
  • Space use types is required before building types can be added.
  • Project status types is required before the projects layer can be added.
  • The projects layer is required before the future buildings layer can be added.
You must format your data for ArcGIS Online to read it correctly. The data manager allows you to add, edit, and configure your data in a simplified manner. Access the data manager using the manage button Settings button in the upper right of the header in the overview. It consists of the following sections:

  • General Settings—General, 3D Base Layers, Public Engagement, and Street View
  • Types—Space Use, Zoning, Land Use, Building, Project Status, and Feedback Categories
  • Layers—Zoning Boundaries, Land Use Boundaries, Overlay Boundaries, and Parcel Boundaries
  • Plans & Projects—Plans, Projects, and Future Buildings
  • Indicators—Living Atlas Indicators and Custom Indicators

Use a template

In some data fields, you can upload data from a spreadsheet on your computer. In such cases, a template is available for download. The template includes default data (for example, the default building types) in a structured table format. You can use this template to help you prepare your data. Use the template to structure your data. Once you are satisfied with the table, you can add it to the data manager, and the contents are visible.

To access the template, complete the following steps:

  1. Open the data manager.
  2. Click the section in which you want to upload data.
  3. Click the Add button at the upper right of the section you are in.
  4. Select From Spreadsheet.

    The From Spreadsheet dialog box appears.

  5. On the dialog box, click Download template.

    An Excel file is downloaded.

Alternatively, if your data has been prepared and added to ArcGIS Online, you can upload it to the data manager using the From Feature Table/Layer upload option (where possible). This workflow is available for types, layers, plans and projects, and indicators. A table (hosted) is the feature layer type used for the Types tab, and a feature layer (hosted) is the type used for the Layers tab.


The content in the downloaded template is case sensitive. You must keep that in mind when editing it. For example, in the BuildingTypes template, there is a FootprintShape column. If you add the word Parcel to this column, the building footprint of the respective building type adapts to the parcel shape. However, if you type parcel (lowercase), the data manager import does not interpret the string as the keyword for adjusting the building footprint according to the parcel's shape.


Consider the following when preparing your data and uploading it to the data manager:

  • Ensure that there are no duplicate or overlapping features in your zoning, land use and parcel layers.
  • Ensure that the feature layer of your zoning, land use, overlays, and parcels boundaries contains only a single sublayer.
  • Ensure that the Zoning Type or Land Use Type field in your zoning or land use boundaries layer refers to the Join ID value of your zonin types or land use types data.
  • Some attributes require a JSON string as an input (for example, Allowed Space Use Types in Zoning Types). Ensure that this JSON has the correct format. The schema is explained in detail in the corresponding spreadsheet templates. You can download them in the data manager.
  • When you use spreadsheet templates to upload your data, the string values are case sensitive. The schema is explained in detail in the template.
  • For the Parcels layer, enure that the number of edges in the EdgeInfos field matches the number of edges of the parcel's geometry.
  • Edits in the data manager don't affect existing plans.

In this topic
  1. Use a template
  2. Tips