Odoo Community Association

Project State Extend

Beta License: AGPL-3 OCA/project Translate me on Weblate Try me on Runboat

This module extends Odoo’s project state selection widget to allow adding extended state options beyond the standard ones (On Track, At Risk, Off Track, On Hold).

Custom states can be configured with:

Custom states are available for Projects through the same state selection widget used by native Odoo.

Table of contents

Configuration

To configure custom project states:

  1. Go to Project > Configuration > Extended States
  2. Click Create
  3. Fill in the form:
    • Name: Display name for the state (e.g., “Pending Review”)
    • Technical Name: Unique identifier (lowercase, no spaces, e.g., “pending_review”)
    • Color: Select a color index from 0 to 11 for the status bubble
    • Sequence: Lower numbers appear first in selection lists
    • Active: Uncheck to archive the state
  4. Click Save

The extended state will now be available in the state selection widget for Projects.

Note: Technical names must be unique across all extended states.

Usage

After configuring extended states, you can use them in Projects:

For Projects:

  1. Open a project
  2. Below the standard “Status” field, you’ll see the “Custom State” field
  3. Click to select from available extended states
  4. The selection will save automatically

The extended state field uses the same widget as the native status field, providing a consistent user experience with colored status bubbles.

Kanban View:

Custom states are also visible in Kanban views for Projects, with the configured color displayed as a status bubble.

Bug Tracker

Bugs are tracked on GitHub Issues. In case of trouble, please check there if your issue has already been reported. If you spotted it first, help us to smash it by providing a detailed and welcomed feedback.

Do not contact contributors directly about support or help with technical issues.

Credits

Authors

  • Escodoo

Maintainers

This module is maintained by the OCA.

Odoo Community Association

OCA, or the Odoo Community Association, is a nonprofit organization whose mission is to support the collaborative development of Odoo features and promote its widespread use.

This module is part of the OCA/project project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.