> ## Documentation Index
> Fetch the complete documentation index at: https://docs.camo.ag/llms.txt
> Use this file to discover all available pages before exploring further.

# Create/Edit Company Map Layers

> Learn how to create and edit company map layers to customize the map view for your organization.

## Overview

Company map layers are custom layers of points or boundaries that are private to your organization. Once created, they appear on the map for everyone in your account under **Company Layers**, grouped by the category you assign.

There are two shape types:

**Boundary layers** — collections of areas or polygons, such as sales territories, service areas, or elevator draw regions.

**Point layers** — collections of locations, such as retailers, facilities, grain elevators, or applicator sites.

There are two ways to build a layer: import an existing GIS file, or create the layer manually and add features to it one at a time.

<Note>
  Creating and editing company map layers requires the **Create/Edit Company Map Layers** permission (Map Layers feature area, CamoAg Enterprise). Without it, users can still view and toggle company layers on the map, but the **New Company Layer** button and all editing options are hidden. See [Access Control (RBAC)](/account-settings/role-based-access-control) for how to add a permission to a role.
</Note>

## Where to start

<Steps>
  <Step title="Open the Company Layers panel">
    From the map, expand **Company Layers** in the left navigation menu.
  </Step>

  <Step title="Click New Company Layer">
    Choose **Boundary layer**, **Point layer**, or **Import shapefile** from the dropdown.
  </Step>
</Steps>

## Importing a map file

Importing is the fastest path when you already have your geography in a GIS file. CamoAg reads the file, verifies it, and creates a layer with one feature per shape in the file.

<Info>
  Accepted formats are `.zip` (a zipped shapefile), `.geojson`, and `.kml`, up to **20 MB**. Files must contain less than **25k features**. To upload a larger file or a different format, contact support.
</Info>

<Steps>
  <Step title="Open the import modal">
    Click **New Company Layer > Import shapefile**. The **Import GIS File** modal opens.
  </Step>

  <Step title="Select your file">
    Drag and drop your file onto the upload area, or click to browse. The file uploads and is verified automatically — watch for **File is verified!** before continuing. If verification fails, the specific error is shown beneath the file name so you can correct the file and try again.
  </Step>

  <Step title="Name the layer">
    The **Layer Name** is pre-filled from the file name. Edit it to whatever you want users to see on the map.
  </Step>

  <Step title="Select a Title Property">
    After verification, CamoAg lists the attribute fields found in your file with an example value from the first record. Pick the field that should be used as each feature's title on the map — for example, `TERRITORY_NAME` or `SITE_ID`.
  </Step>

  <Step title="Add a source URL (optional)">
    Click **Enter Source URL** to record where the data came from. This is useful for layers sourced from a public agency dataset that you may need to refresh later.
  </Step>

  <Step title="Upload">
    Click **Upload**. Processing runs in the background and can take several minutes for large files — you'll be notified when the layer is ready.
  </Step>
</Steps>

<Tip>
  The shape type (boundary or point) is detected from the file, so there's no need to choose it beforehand.
</Tip>

## Creating a layer manually

Manual creation is a two-part process: first you define the layer itself, then you add features to it.

### Step 1: Define the layer

<Steps>
  <Step title="Choose the layer type">
    Click **New Company Layer** and select **Boundary layer** or **Point layer**. This cannot be changed after the layer is created.
  </Step>

  <Step title="Enter a Layer Name">
    This is the name users will see in the Company Layers list. Required.
  </Step>

  <Step title="Choose a Layer Category">
    Categories group related layers together in the navigation menu. Select an existing category from the dropdown, or click **Create** to type a new one. Layers default to the **Other** category.
  </Step>

  <Step title="Pick a Default Display Color">
    Choose the color used to draw this layer on the map. Boundary layers can be left with no color (an outline only) by clearing the selection; point layers default to gray.
  </Step>

  <Step title="Add Feature Attributes">
    Attributes are the custom fields available on every feature in the layer — for example, `Account Owner`, `Acres`, or `Contract End Date`. Click **Add attribute** for each one and give it a label. Use the arrows to reorder attributes; the order here is the order users see when viewing a feature.
  </Step>

  <Step title="Save">
    Click **Save**. The layer is created and you're taken to its details page, ready to add features.
  </Step>
</Steps>

### Step 2: Add features to the layer

From the layer's details page, click **Add feature to layer**.

<Tabs>
  <Tab title="Point layers">
    A new point is dropped at the center of your current map view. In the form, set the **Title**, fill in any feature attributes, and optionally add an address. Latitude and longitude are shown read-only — reposition the point by dragging it on the map. Click **Save**.
  </Tab>

  <Tab title="Boundary layers">
    The boundary edit tools open on the map. Build the shape using:

    * **Draw Polygon** — trace the boundary by hand
    * **Multi-select** — click existing map features, such as counties or townships, to use their geometry
    * **Merge Boundaries** — combine multiple selected shapes into one
    * **Cut** — remove a section from a shape
    * **Simplify** — reduce the number of vertices on a complex shape
    * **Delete** — remove a shape and start over

    When the geometry is right, click **Finish Selection**, then enter a **Feature Name**, fill in your feature attributes, and click **Save**. Use **Edit feature on map** to return to the drawing tools.
  </Tab>
</Tabs>

Repeat for each feature. The feature count is shown in the layer header as you go.

## Editing a layer

Open the layer from **Company Layers** and use the menu in the layer header:

| Action              | What it does                                                                                                                           |
| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| Edit Layer Settings | Change the layer name, category, display color, and feature attributes                                                                 |
| Archive Layer       | Removes the layer from the map. Available once the layer contains features — it can be reinstated within 30 days by contacting support |
| Delete Layer        | Permanently deletes the layer. Only available while the layer is empty                                                                 |

<Note>
  Existing feature attributes can't be deleted once features are using them — use the eye icon to hide an attribute instead. New attributes you've added but not yet saved can be removed with the trash icon.
</Note>