Skip to content

Projects

Overview

Projects in UptimeHunt provide organizational structure for grouping related monitoring services. This feature enables logical categorization of services by environment, customer, application, or any other criteria relevant to your use case.

Understanding Projects

Purpose

Projects serve multiple organizational functions:

Logical Grouping
Group related services together for easier management
Visual Organization
Use colors to distinguish between different project types
Service Organization
Maintain clean, organized service lists
Team Structure
Organize services by team, department, or responsibility

Project Attributes

Each project consists of the following attributes:

Attribute Required Description
Name Yes Unique identifier for the project
Description No Detailed description of the project's purpose
Color No Hex color code for visual identification (default: #3B82F6)
Icon No Icon identifier for visual representation
Order System Display order (managed through reordering feature)

Creating Projects

Access Project Creation

  1. Navigate to the Services dashboard
  2. Click "Manage Projects" button
  3. In the project management modal, click "Add Project"

Configure Project Details

Project Name (Required)
Unique name within your account
Maximum 128 characters
Examples: "Production", "Staging", "Customer Sites"
Description (Optional)
Detailed information about the project
Maximum 500 characters
Use for documentation or team reference
Color (Optional)
Hex color code (e.g., #FF5733)
Default: #3B82F6 (blue)
Used for visual identification in the dashboard
Icon (Optional)
Icon identifier for project representation
Currently limited to available icon set
Leave empty for default appearance

Save Project

Click "Create Project" to save the new project. The project will immediately appear in:

  • Project management list
  • Service assignment dropdown
  • Dashboard project sections

Managing Projects

Viewing Projects

Project Manager

Access from Services dashboard → "Manage Projects" button

Displays:

  • All projects in your account
  • Project details (name, description, color)
  • Service count per project
  • Management actions (edit, delete)

Dashboard View

Projects appear as collapsible sections containing their assigned services.

Editing Projects

To modify an existing project:

  1. Open the project manager
  2. Locate the project in the list
  3. Click the Edit button
  4. Modify project attributes
  5. Click "Save Changes"

Changes take effect immediately across the platform.

Deleting Projects

To remove a project:

  1. Open the project manager
  2. Locate the project to delete
  3. Click the Delete button
  4. Confirm the deletion when prompted

Service Reassignment

Services assigned to a deleted project are automatically moved to the "Unassigned" category. The services themselves are not deleted.

Reordering Projects

Project display order can be customized:

Enable Reorder Mode

  1. Navigate to Services dashboard
  2. Click "Reorder Projects" button
  3. Dashboard enters reorder mode

Adjust Order

  1. Click and hold a project header
  2. Drag to desired position
  3. Release to drop in new location
  4. Repeat for additional projects

Complete Reordering

Click "Done Reordering" to exit reorder mode. The new order is saved automatically and persists across sessions.

Assigning Services to Projects

During Service Creation

When creating a new service:

  1. Complete basic service configuration
  2. Locate the "Project" dropdown
  3. Select the desired project
  4. Complete service creation

Services without project assignment appear in the "Unassigned" section.

Changing Service Project

To reassign an existing service:

  1. Navigate to service details or edit the service
  2. Locate the "Project" dropdown
  3. Select a different project
  4. Save the service configuration

The service immediately moves to the new project section on the dashboard.

Unassigning Services

To remove project assignment:

  1. Edit the service
  2. Set Project dropdown to empty/none
  3. Save changes

The service moves to the "Unassigned" section.

Project Best Practices

Naming Conventions

Establish clear naming conventions:

Environment-Based
Production, Staging, Development, Testing
Customer-Based
Customer A Services, Customer B Services, Internal
Application-Based
Website Monitoring, API Services, Database Servers
Team-Based
DevOps Team, Frontend Team, Backend Team

Color Coding

Use consistent color schemes:

Environment Scheme 

Production: Red (#EF4444)
Staging: Yellow (#F59E0B)
Development: Green (#10B981)

Priority Scheme 

Critical: Red (#DC2626)
Important: Orange (#EA580C)
Standard: Blue (#3B82F6)
Low Priority: Gray (#6B7280)

Organization Strategies

By Environment

Create projects for each deployment environment:

  • Production
  • Staging
  • Development
  • QA/Testing

By Customer

Useful for service providers:

  • Customer/Client name
  • Internal Services
  • Demo/Trial Services

By Application

Group by application or system:

  • Main Website
  • Mobile API
  • Admin Dashboard
  • Payment Processing

Project Limitations

Current Limitations

  • Projects cannot be nested (no hierarchical structure)
  • Services can only belong to one project
  • Project sharing between users not available
  • Project-level permissions not implemented

Future Enhancements

Planned features for future releases:

  • Project templates
  • Project-level monitoring settings
  • Shared projects for team collaboration
  • Project-level reporting
  • Batch service operations by project

Troubleshooting

Cannot Create Project

Duplicate Name Error

Projects must have unique names within your account. If creation fails:

  • Verify project name is unique
  • Check for similar names with different spacing
  • Try a different name

Validation Errors

Ensure all requirements are met:

  • Name field is not empty
  • Name doesn't exceed 128 characters
  • Description doesn't exceed 500 characters
  • Color code is valid hex format (if provided)

Project Not Appearing

If a newly created project doesn't appear:

  1. Refresh the browser page
  2. Close and reopen project manager
  3. Verify creation was successful (check for errors)
  4. Clear browser cache if necessary

Cannot Delete Project

If project deletion fails:

  • Ensure you have appropriate permissions
  • Try refreshing the page
  • Verify network connection
  • Contact support if issue persists

Services Not Appearing in Project

If assigned services don't show in project:

  1. Verify service is actually assigned to project
  2. Check service is enabled
  3. Refresh the dashboard
  4. Confirm service wasn't accidentally deleted