Projects enable you to manage your work more effectively and is aligned with the way your business works. You can organize your sites in layers, quickly filter and find content organized in the project panel, and easily move and share sites between projects.

Content within projects, such as: your Sites, Reports, and Custom Data are included and available in a centralized location. This data can be accessed via Business Analyst apps —from Mobile to Web to Desktop or as individual Item types in ArcGIS Online or ArcGIS Enterprise.


When you sign in to ArcGIS Business Analyst Web App for the first time and go to the Maps tab, the My Projects tab will be empty. To begin working you must first click Create Project to create a project. Alternatively, if another user has shared a project with you, you can access it under Projects shared with me.

Add New Project

In subsequent sessions, when you sign in and go to the Maps tab, you will see a list of your previously created projects. To work on a project, move the pointer over the project thumbnail and click Open. You may also click Create Project to create a new one.

My Projects

When you click Open, the project is opened in the Maps tab, on the left.

The project you chose will be opened. To switch to a different project, return to the Projects view by clicking All Projects.

The items in your selected project are displayed. Expand any of the sections (Point Locations, Polygons, …) to view the layers.

Click Edit Edit to add a new layer to a section.

Add new layer

Expand any of the layers to view the sites contained within. Click on Edit to view other options for a layer or an item.

Create project

To create a new project you will perform the following steps:

  1. From the All Projects view, click Create Project.

    The Create Project dialog box opens.

    Create project

  2. In the Project name field, enter a name for the project. You may optionally click Customize project attributes to customize, add, and remove attributes for the project.
  3. Click Add attribute to add more attributes for the project.
    Add attributes
  4. Move the pointer over an attribute to see more options:
    • Click Edit Edit an attribute to edit the attribute name.
    • Click Remove Remove an attribute to remove that attribute from the project

      Move the pointer over any of the More information icons More information for more information. Expand any of the drop-down menus to see options.

      Attribute options
      The Number drop-down has the following options:
      • Double (Default)—The default format. Supports large numbers with fractional values. Suitable for attributes representing area—for example, sq. miles.
      • Float—Supports smaller numbers with fractional values. Suitable for attributes representing ratios.
      • Long—Supports large whole numbers—for example, building square footage or property record ID numbers.
      • Short—Supports small whole numbers—for example, number of floors in a building.

      The Set Validation drop-down has the following options:

      • Range Allows you to set a minimum and maximum value for the attribute. Values outside this range will not be allowed.
        Set square foot range
        Only one value from the Minimum and Maximum fields need be specified—for example, the minimum number of parking spaces acceptable is 100. The Minimum field could be set to 100 and the Maximum field left blank.
      • Preset values Allows you to list the permitted values for the attribute. Any value, not explicitly listed, will not be allowed—for example, you add an Historically significant attribute which has only two permitted values: Yes, No. You can set the attribute format to Text and Length to 1 (maximum allowed length is 254) and the Preset values to Y, N. You can enter descriptive information for each preset value in the corresponding Name field. Click Add value to specify additional values.
        Setting historically significant preset values

  5. When finished customizing attributes, click Create.
    Click Create

    A project will be created and a thumbnail for the new project will appear in the All Projects view.


    After a project has been created, you can still customize, add or remove attributes for any layer in the project. See Layer options below.


    When sites are created in this project, you can only enter values for the attributes that satisfy the validations you had set when the project was created. An invalid value will not be accepted and an error message will be returned. You can modify validations for any layer in the project.

    Invalid value entered

Layer options

When you have more than one layer within the Point Locations, Polygons, or Geographies sections, you may change the target layer at any time by clicking Edit Edit next to it, and clicking Make target. The target layer is where any new site you create will get saved by default. You will also see additional options.

Make target
  • Zoom to layer—Zoom to the layer on the map
  • Rename item—Rename the layer
  • Delete item—Delete the layer
  • Show attribute table—Open the attribute table for the layer
    Attribute table
  • Edit attributes: Edit the attributes and validation rules for the layer. Click Edit Edit an attribute to edit the attribute name and Remove Remove an attribute to delete it. Click Add attribute to add a new attribute. For detailed information on validation rules, see Create Project above.
    Edit Layer Attributes

    Editing the validation for an attribute may cause invalid values for existing sites, which may cause issues for items you created using this project, such as custom infographic templates and custom reports. For example, assume that you already have a site with a value of 250000 for the Building Area attribute. If you edit the validation to lower the Maximum to 230000, then that site will now have an invalid value for the Building Area value.

  • Filter by attributes—Filter the items in the layer based on the attributes values—for example, you want to filter a site layer to show sites that are > 15,000 and have more than 50 parking spaces. You choose those attributes in the drop-down (Image 1) and then adjust the filters accordingly (Image 2).
    Filter layer attributes
    Image 1
    Adjust filter
    Image 2

    When using a text field to filter, you can press the space key to quickly see up to 20 unique values. If you entered a search string, it will be highlighted in available options as shown below, with the option to select all returned results.

    Filtering by text.


    When a filter is enabled on a layer, the filtered version of the layer will be applied when it is used in a workflow—for example, in Suitability Analysis as a competitor layer. To use the original layer, you must first disable the filter.

    To continue without saving, click Done. In the project content on the left, a red dot against the layer name will indicate that a filter has been applied to it. Click Options Site options to open layer options—the Filter by attributes toggle will be enabled. Use this toggle to quickly disable/enable the filters. To modify or clear the filters, click Filter by attributes.

    My Sites' options

    To save the filtered version of the layer, click Save as new layer. For site layers, just specify a name for the new layer, and click Save.

    Save as a new layer.

    When filters are applied to a points layer—for example, points returned by a business and facilities search, you will have the option to save only the points or create and save sites for the filtered points.

    Save only points

    If the filtered layer has greater than 1000 points, sites will only be created for the first 1000.

  • Setup Layer—This option enables you to setup a layer for use in analysis and reports. Web maps are listed in the Web Maps and Layers section. Territories are listed under the Territories section. Layers created from business search results and imported files are available under the Other Layers section. Click Options layer options next to the point or polygon layer that you want to setup and click Setup layer. You may need to expand a Web Map or Territory listed here to view the layers in it.
  • Expand all— This option is only available for the Other Layers section.
    Expand all Other Layers

    Click Options Expand for the section and then click Expand all. Any layers with symbology will be expanded and you won't need to expand each individually.

    Layers and symbology shown when expanded.
    For example, in the above screen capture there are two business search result layers. They are expanded when you click Expand all, to show the symbology for the layers.

Site options

Click on the black arrow next to a layer name to expand and view the items contained within. Click Options Options to view other options for a layer or an item contained within.

Other options
  • Show details—Open the site details in edit mode.
  • Zoom to site—Zoom to the site on the map.
  • Run reports—Run a report for a site.
  • Run infographics—Run infographics for a site.
  • Rename item—Rename a site.
  • Edit site—Edit the results of a site by choosing another location, editing a polygon, adding rings, drive times or bands and getting reports.
  • Move item—Move sites to different layers within the same section.
  • Delete item—Delete a layer or a site.

Show details

Clicking on Show details will open the site details in editable mode:

Site details in edit mode
  • Move the pointer over the site name and click Edit Edit button to rename the site.
  • Click Add photo > Browse to upload a photo for the site from your device.

    The added photo will be displayed under the site name at the top. Panoramic and 360 degree photos are also supported and indicated by icons in the top left. Move the pointer over the photo for more options:

    • Scroll through the photos by clicking the arrow buttons on either side.
    • Click Remove to remove the photo.
    • Click Gallery in the bottom right to view a gallery of all the photos for the site—here, you can add captions for photos, and click Image order to change the order of the photos.

    Click on a photo to view it in the Photo Viewer. In that mode, you can pan a 360 degree photo and view the full extent. For panoramic photos, you can zoom in and then pan.

  • Move the pointer over any of the Attributes (Building Area, Frontage, and so on) and click Enter value to modify the value.
  • Notes—Click Add to enter notes for the site.
  • Attachments— An attachment is a document or image with additional relevant information about the site-for example, a PDF floorplan of a building at the site location, or an image of the building. Click on any attachment in the list to open it. To add a new attachment, click Add. The Add attachment dialog box opens.
    Add document from URL
    In the Choose File drop-down menu, select Browse to upload a document or image from your device.

    Images will be added to the photo gallery.

  • Under the Reports section, you will see a list of reports previously run for the site.

Run reports

You can run a report for a site.

  • Click the Run reports button option. The Reports view is launched.
  • Click Add to select a report .
  • Click Run Now.

Run infographics

You can run infographics for a site.

  • Click the Run infographics button option. The infographics template is launched.
  • You may edit, share, export, or print the infographic.

Rename item

You can rename a site.

  • Click the Rename item button option. The name is highlighted.
  • Type a new name.

Edit site

You can edit the results of a site by choosing another location, editing a polygon, adding rings, drive times or bands and getting reports.

  • Click the Edit site option. The dialog box appears for you to make the edits.

Move item

You can move sites to different layers within the same section.

  • Click the Move item option. The Move dialog box appears.
  • Click on the layer to where you wish to move the site. Click Move.

Delete item

When deleting a layer, you delete the layer and the sites in it.

  • Click the Delete item option.
  • Click OK in the Confirm Delete dialog box.
  • To delete multiple sites at once, use Shift + click to highlight multiple sites. Then click on Show options next to any one of the selected sites, and click Delete items.
Delete items


Deleting a layer or site is permanent. The deleted content is also removed from your Project Data in ArcGIS Online (see Your content in ArcGIS Online).

All Projects

You can manage your projects within the All Projects view. You can move items between layers, rename items, layers and projects, launch ArcGIS Online to share your projects with other users.

Click All Projects to open the All Projects dialog box.

My Projects in detail

You can perform several operations from the All Projects screen:

  • Click the project in the Change current project drop-down to view the list of projects, and open a different project.

    If you have any items on the map, the Clear Map dialog box will appear. Click Yes to clear the map of those items. You may select the check box to save this choice under Preferences > General > Projects, and not see this dialog again.

    Clear map

  • Click the Projects shared with me tab to view the projects shared with you. See Shared projects.
  • Click Edit Rename a project to rename a project.
  • Click Delete Delete a project to delete a project. You may not delete the current project. To delete the current project, you must first select a different project in the Change current project drop-down menu.
  • Click Share Share icon to share a project with other users.
  • Move the pointer over a project thumbnail and click Manage Items to organize the items in the project.
Project A layers

Click Edit Edit to view options. Click Add to the map to add the items contained within the layer to the map. Click Rename item to rename the layer.

Click Expand Expand layer contents to expand it and view the items contained within it.

View options

Click the Edit next to an item name to view options.

  • Clicking Remove from the map will take you to the map view and add the item to the map.
  • Clicking Zoom to site will allow you to zoom to the site on the map.
  • Clicking Rename item will allow you to rename it.
  • Clicking Edit site (when applicable and available) will open the item in Edit mode.
  • Clicking Move item will open the Move dialog box, and you can select a different layer to move the item to—for example, in the following screen capture the layer Point Locations B is selected.

    Since a Point Location was selected, you can only choose to move it to another Point location layer.

  • Clicking Delete item will prompt for confirmation to delete the item.

You may also move it to a Point location layer in another project. Click BrowseBrowse to browse and select a point location layer in another project.

Select the Keep a copy check box to move the item, but still retain the item in its current layer.

Click Move.

Move a layer

Share projects

The project-based structure allows you to share your projects with other users, and enables other users to share their projects with you, thus facilitating easy collaboration.

Click Share Share icon in the project thumbnail, to share a project from the All Projects view.

Project Manager

The Share the Project with Other Users dialog box appears.

  • Add entire organization is selected by default, which allows you to share the project with all other users in your organization.
  • To share with specific user(s), choose Add individual users from your organization, and select the users by clicking the check box. You may select the Select all check box to select all users, which would be the same as using the Add entire organization option.

    If you need to share a project with all users except for a few, use the following shortcut: click Select all to select all users, and then deselect just those specific users.

  • To search for specific users, click Search Search icon and enter the search term.

In this example, one user is selected. Click Apply.

Share the project with others

The project is shared with the selected user(s). The new state of the icon in the project thumbnail indicates that the project is shared.

Project is shared

You may click the shared icon to reopen the Share the Project with Other Users dialog box. You may then review or modify the list of users the project is shared with, by selecting additional users or deselecting a currently selected user.

Manage project users

To modify the list of users the currently open project is shared with, you may click the share icon in the project panel.

Click share icon to modify list of users

Projects shared with you

Other users may invite you to their projects. Click Projects shared with me to view a list of projects other users have shared with you.

List of projects shared

To work with the items contained within a shared project, move the pointer over the thumbnail and click Manage Items. You can add an item—for example, a site from this project to the map, move items between layers, rename an item, and so on. To open a shared project, click Switch to this Project.

To make sure the projects most recently shared with you are listed, click Refresh Refresh project list to refresh the list. Use the options in the Sort by: drop-down to choose a different way to order the list of projects.

Step-by-step guide

In this step-by-step guide, you will learn how to get started using the Projects structure to create and store your content.


Step-by-step guide to creating a Project.

Your content in ArcGIS Online

You can access the content in your projects in ArcGIS Online and share it with other users in your organization or with all users of ArcGIS Online. You will use this page to organize, access, and work with your content.

After signing in to ArcGIS Online, go to Content.

My Content on ArcGIS Online

The Groups that you belong to are listed under the Groups tab. Projects in ArcGIS Business Analyst Web App are listed under the Groups tab. The list of groups here will include the Projects you created, and those other users shared with you. You may invite other users to a Group you own (see Shared Projects).

Your page should look similar to what is shown below.

My Content folder structure

While Business Analyst content is directly accessible through projects and its Project Manager feature, the content is also available as Items within ArcGIS Online or ArcGIS Enterprise. Learn more about Items here:

Learn more about the ArcGIS geoinformation model here:

Business Analyst creates folders in the ArcGIS My Content page so that your analyses are automatically saved. These layers and items can be added to Business Analyst apps (Web, Desktop, etc). More information about these Business Analyst specific folder are listed below:

  • your_username (Home)—This is the default folder when publishing hosted services from any ArcGIS application, including Business Analyst Web App and ArcGIS Online.
  • BA - Application Data—This folder contains all your Business Analyst configurations, preferences, saved variables including Color-Coded Maps, Smart Map Searches, Comparison Reports Data, and Project preferences.
  • BA - My Maps—This folder contains items that you share from Business Analyst Web App to ArcGIS Online using the ArcGIS Web Map workflow and story maps created using the Story Map workflow.
  • BA - My Reports - Ordered Reports—This folder contains PDFs that are created using the PDF or Image workflow, and reports in PDF, All-In-One PDF, and Excel formats created using the Run Reports workflow.

    Some users will also see these folders:

    • BA - My Reports - Custom PDF Map Reports—folder contains previously created PDFs using the Create PDF or Image workflow. These PDFs created now are saved under BA - My Reports - Ordered Reports.
    • BA - My Reports - All-in-One Reports—This folder contains previously created All-In-One reports using the Run Reports workflow. All-In-One reports created now are saved under BA - My Reports - Ordered Reports.

  • BA - Project Data—This folder contains the data (feature service) that stores your sites and additional layers from Projects created in Business Analyst Web App or from Business Analyst Desktop.
  • BA - Report Themes—This folder contains custom infographic themes saved using the Build Infographics workflow.
  • Custom Data—This folder contains the Custom Data that you created using the Custom Data Setup workflow in Business Analyst Web App or from Business Analyst Desktop.
  • Report Templates—This folder contains report templates you created in Business Analyst Web App, including templates using Build Reports, Build Infographics, and Comparison Reports workflows. It also contains custom report templates created using Business Analyst Desktop.