Projects help you organize addresses, territories, and sales campaigns. Each project groups related addresses together for focused management and tracking.
What is a Project?
A project represents:
- A territory - Geographic area you're working
- A campaign - Time-limited sales effort
- A client - Addresses for a specific customer
- A product launch - Addresses targeted for a new product
Accessing Projects
- Ensure you're in your team account
- Click Projects in the sidebar
- The URL is
/home/[team]/projects
Projects List
Table Columns
The projects table shows:
| Column | Description |
|---|
| Name | Project name |
| Status | Active, Draft, Completed, or Cancelled |
| Start Date | Project start date (if set) |
| End Date | Project end date (if set) |
Filtering Projects
Filter the list by:
- Search - Search by name, status, or description
- Status - Filter by one or more statuses (Active, Draft, Completed, Cancelled)
By default, only Active and Draft projects are shown.
Creating a Project
New Project
- Click New Project button
- Enter project details:
- Name - Project title (required)
- Description - Purpose and notes
- Start Date - When the project begins
- End Date - When the project ends
- Allow salesmen to create addresses - Permission setting
- Click Create Project
You'll be redirected to the project configuration page after creation.
Project Fields
| Field | Required | Description |
|---|
| Name | Yes | Project identifier |
| Description | No | Details about the project |
| Start Date | No | Project start |
| End Date | No | Expected completion |
| Allow salesmen to create addresses | No | Allow members to add addresses |
Project Statuses
| Status | Description |
|---|
| Active | Currently in progress |
| Draft | Not yet started |
| Completed | Finished successfully |
| Cancelled | Terminated |
Project Detail
Accessing Project Detail
Click a project row to view its detail page.
Project Tabs
Each project has five tabs:
| Tab | Description |
|---|
| Overview | Project summary (default tab) |
| Configuration | Project settings |
| Addresses | List of project addresses |
| Sales | Sales from this project |
| Map | Geographic view with zones |
Project Navigation
Overview Tab
The landing page for a project showing summary information.
Configuration Tab
Project settings including:
- Edit project details
- Zone management
- Product assignments
- Sale model assignment
- Delete project option
See Project Configuration for details.
Addresses Tab
View and manage project addresses:
- Table view of all addresses
- Filter and search
- Add new addresses
- Import addresses from CSV
- Bulk actions
See Project Addresses for details.
Sales Tab
Track project sales:
- Sales list with filters
- Status management
- Bulk state transitions
See Project Sales for details.
Map Tab
Interactive geographic view:
- Address markers
- Zone overlays
- Drawing tools
- Color-coded interaction states
See Map View for details.
Managing Projects
Editing a Project
Users with projects:update permission can edit:
- Navigate to the project
- Click the actions menu (three dots) on the projects list
- Select Edit Project
- Update project details in the dialog
- Save changes
Or from within the project:
- Go to the Configuration tab
- Edit the project settings
Cancelling a Project
To cancel a project:
- Click the actions menu on the project row
- Select Cancel
- The project status changes to Cancelled
Cancelled projects:
- Can be filtered to view in the projects list
- Can be reactivated if needed
Reactivating a Project
To reactivate a cancelled project:
- Click the actions menu on the cancelled project
- Select Reactivate Project
- The project returns to its previous status
Viewing Audit History
Team owners can view project audit history:
- Click the actions menu on the project row
- Select Audit History
- Review the change history
Project Zones
Zones help divide a project geographically:
- Draw zones on the map
- Assign addresses to zones
- Track progress by zone
- Filter data by zone
See Map View for zone management.
Permissions
Required Permissions
| Action | Permission Required |
|---|
| Create project | projects:create + active subscription |
| Update project | projects:update + active subscription |
| View audit history | Owner role |
Best Practices
Project Organization
- Use descriptive names - Clear project identification
- Set date ranges - Define project timeline
- Add descriptions - Document project purpose
- Use statuses properly - Keep project states current
Data Management
- Import addresses early - Set up before starting
- Define zones - Organize geographically
- Configure sale model - Set up workflow before sales begin