Support Center/Managing Project Components
Project Management

Managing Project Components

Learn how to create, edit, and organize project components to structure large projects into meaningful domains and subsystems.

Last updated: February 23, 2026

Managing Project Components

Project Components help you organize large projects into meaningful domains or subsystems. Components sit between Projects and PRDs in the hierarchy, making it easier to track and report on related work.

What are Components?

A Component represents a distinct area or module within your project. For example:

  • User Authentication - Login, registration, password reset
  • Billing & Payments - Subscriptions, invoices, payment methods
  • API Gateway - REST endpoints, rate limiting, authentication
  • Admin Dashboard - User management, analytics, settings

Components can be nested to create hierarchies. For instance, you might have a "Backend" component with child components for "API" and "Database".

Creating a Component

From the Project Settings

  • Navigate to your project
  • Click Settings in the sidebar
  • Select the Components tab
  • Click New Component
  • Fill in the details:
    • - Name - A clear, descriptive name (e.g., "User Authentication") - Description - Brief explanation of what this component covers - Parent Component - Optional, for nested components - Owner - Team member responsible for this component
  • Click Create Component

    • Best Practices for Components

    • Keep it focused: Each component should represent a single domain or subsystem
    • Use clear names: Choose names that make sense to your whole team
    • Assign owners: Having a clear owner improves accountability
    • Don't over-structure: Start with a few key components and add more as needed

    Editing Components

    To update a component:

  • Go to Project Settings > Components
  • Find the component in the list
  • Click the edit icon (pencil)
  • Update the fields as needed
  • Click Save Changes

    • You can change:

    • Name and description
    • Parent component (to restructure the hierarchy)
    • Owner assignment
    • Status (active, deprecated, archived)

    Archiving Components

    When a component is no longer active but you want to preserve its history:

  • Go to Project Settings > Components
  • Find the component
  • Click the archive icon (box)
  • Optionally add a note explaining why
  • Confirm archiving

    • Archived components:

    • Are hidden from most views by default
    • Cannot have new PRDs or tasks assigned
    • Preserve all historical data
    • Can be restored if needed

    Restoring Archived Components

  • Go to Project Settings > Components
  • Toggle Show Archived to see archived components
  • Find the archived component
  • Click the restore icon (circular arrow)
  • The component returns to active status

    • Component Permissions

    ActionViewerMemberAdminOwner
    View components✓✓✓✓
    Assign to PRD/Task✓✓✓
    Create components✓✓
    Edit componentsOwn✓✓
    Archive/restore✓✓
    Delete components✓

    Members can edit components they own. Admins and Owners can edit any component.

    Tips for Organizing Components

    Starting a New Project

  • Identify 3-5 major areas of your project
  • Create a component for each
  • Assign owners based on expertise
  • Create PRDs within each component

    • Large Projects

    For complex projects, consider:

    • Using parent-child relationships to group related components
    • Having a "Core" or "Shared" component for cross-cutting concerns
    • Creating an "Infrastructure" component for DevOps-related work

    Microservices Architecture

    If you're building microservices:

    • Create a component for each service
    • Use a "Gateway" or "API" component for shared interface work
    • Consider a "Platform" component for shared infrastructure

    See Also