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

# Manage Environment Calculated Fields

> Create, update, and delete calculated fields that apply across all datasets in an Environment, so you can standardize metrics and reuse logic team-wide.

For clearer insights and consistency, you can use calculated fields to create new fields by applying functions and logic to existing data.

<Tip>
  Environments exist only in Honeycomb's current release.
  If you use Honeycomb Classic, we recommend [migrating to Honeycomb Environments](/troubleshoot/product-lifecycle/recommended-migrations/#migrate-from-honeycomb-classic-to-honeycomb-environments), so you can take advantage of its expanded data model and future product updates.
</Tip>

## What is an Environment Calculated Field?

In Honeycomb, saved calculated fields can apply to either a specific dataset or an entire environment.
Environment-wide calculated fields let you define reusable computations that apply across multiple datasets and services.

By managing these fields at the environment level, you ensure consistency in data transformation and reduce the need for redundant field definitions.

<Note>
  For a more general introduction to calculated fields, their scopes, and how you can use them in Honeycomb, visit [Use Calculated Fields](/investigate/query/build/calculated-fields/).
</Note>

## Creating Calculated Fields

Define a calculated field to transform or derive new insights from your data.

To create an environment-wide calculated field:

1. Log in to the Honeycomb UI.

2. In the navigation menu, select the **Environment** label, then choose **Manage Environments**.

3. Locate the environment to which you want to add a calculated field, and select its name to open its settings.

4. Go to the **Schema** view.

5. Select **Add New Calculated Field**.

6. In the modal, enter details:

   | Field             | Description                                                                                                                                                                                                                                                                                                                                                                    |
   | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
   | **Display Name**  | Name that appears in the Query Builder. Enter a name that is unique across all datasets and the containing environment. Although Honeycomb tries to prevent duplicate field names, they can still occur. For help resolving naming conflicts, visit [Common Issues with Queries: Calculated Fields](/troubleshoot/common-issues/queries/#a-link-points-to-the-wrong-location). |
   | **Prompt** (beta) | Use natural language to generate a Calculated Field. For example, `return "slow" if $duration_ms &gt; 1000`. Be sure to explicitly reference any schema fields using the $ syntax (for example, `$field\_name\`). For help resolving errors, visit [Common Issues with Queries: Calculated Fields](/troubleshoot/common-issues/queries/#calculated-fields).                    |
   | Editor            | Formula that defines your field. For syntax, available functions, and example formulas, visit [Calculated Field Formula Reference](/reference/calculated-field-expression/).                                                                                                                                                                                                   |

   <Tip>
     Hover over syntax errors (red underlines or red triangles) for suggestions on how to fix them.
   </Tip>

7. Select **Save**.

The screen refreshes, and your new field appears in the list.

## Editing Calculated Fields

Update a calculated field to refine its formula or adjust its name.

<Warning>
  Before changing a calculated field, check for dependencies that may be affected, such as Boards, Triggers, and SLOs.
</Warning>

To edit an environment-wide calculated field:

1. Log in to the Honeycomb UI.

2. In the navigation menu, select the **Environment** label, then select **Manage Environments**.

3. Find the environment containing the calculated field you want to change, and select its name to open its settings.

4. Go to the **Schema** view.

5. Locate the calculated field in the list, and select **Edit**.

   <Frame>
     <img src="https://mintcdn.com/honeycomb/TbuCbl4WLlWBh-kz/_assets/images/calculated-fields/calculated-field-schema-edit.png?fit=max&auto=format&n=TbuCbl4WLlWBh-kz&q=85&s=493b56929c1bb02be219668c4c0bdbd2" alt="Edit calculated field" width="1322" height="414" data-path="_assets/images/calculated-fields/calculated-field-schema-edit.png" />
   </Frame>

   1. If dependencies exist, Honeycomb will prompt you to either [clone the field](#cloning-calculated-fields) or continue editing.
      If you are unsure, contact the field's most recent editor before proceeding.

      <Frame>
        <img src="https://mintcdn.com/honeycomb/TbuCbl4WLlWBh-kz/_assets/images/calculated-fields/calculated-field-edit-dependencies-modal.png?fit=max&auto=format&n=TbuCbl4WLlWBh-kz&q=85&s=fee5682cb03cd2a4293bd9bec3b97028" alt="Edit a calculated field modal with a dependency" width="673" height="258" data-path="_assets/images/calculated-fields/calculated-field-edit-dependencies-modal.png" />
      </Frame>

6. In the modal, modify the pre-populated name and formula as needed.
   For syntax, available functions, and example formulas, visit [Calculated Field Formula Reference](/reference/calculated-field-expression/).

7. Select **Save**.

The screen refreshes, and the edited field updates in the list.

## Cloning Calculated Fields

If you need a new calculated field similar to an existing one, you can clone the existing calculated field and modify it as needed.

To clone an environment-wide calculated field:

1. Log in to the Honeycomb UI.

2. In the navigation menu, select the **Environment** label, then select **Manage Environments**.

3. Find the environment containing the calculated field you want to clone, and select its name to open its settings.

4. Go to the **Schema** view.

5. Locate the calculated field in the list, and select **Clone**.

   <Frame>
     <img src="https://mintcdn.com/honeycomb/TbuCbl4WLlWBh-kz/_assets/images/calculated-fields/calculated-field-clone.png?fit=max&auto=format&n=TbuCbl4WLlWBh-kz&q=85&s=8a1a76c9a6e336a7f75a82dffea97db3" alt="Clone a calculated field from the table" width="1042" height="342" data-path="_assets/images/calculated-fields/calculated-field-clone.png" />
   </Frame>

6. In the modal, modify the pre-populated name and formula as needed.
   For syntax, available functions, and example formulas, visit [Calculated Field Formula Reference](/reference/calculated-field-expression/).

7. Select **Save**.

The screen refreshes, and your new field appears in the list.

## Deleting Calculated Fields

To manage your data effectively, you may need to delete calculated fields that you no longer need.

<Warning>
  Before removing a calculated field, check for dependencies that may be affected, such as Boards, Triggers, and SLOs.
</Warning>

<Info>
  To delete a calculated field, you must be its creator or a [Team Owner](/configure/teams/manage-permissions/).
</Info>

To delete an environment-wide calculated field:

1. Log in to the Honeycomb UI.

2. In the navigation menu, select the **Environment** label, then choose **Manage Environments**.

3. Find the environment containing the calculated field you want to delete, and select its name to open its settings.

4. Go to the **Schema** view.

5. Locate the calculated field in the list, and select **Delete**.

   <Frame>
     <img src="https://mintcdn.com/honeycomb/TbuCbl4WLlWBh-kz/_assets/images/calculated-fields/calculated-field-schema-delete.png?fit=max&auto=format&n=TbuCbl4WLlWBh-kz&q=85&s=efbd8942969740dc24f73b25eb675241" alt="Delete calculated field" width="1322" height="414" data-path="_assets/images/calculated-fields/calculated-field-schema-delete.png" />
   </Frame>

   1. If dependencies exist, a list will appear.
   2. To continue, remove all dependencies.
      If you are unsure, contact the most recent editor of each dependency before proceeding.
   3. Select **Refresh Dependencies**.

      <Frame>
        <img src="https://mintcdn.com/honeycomb/TbuCbl4WLlWBh-kz/_assets/images/calculated-fields/calculated-field-delete-dependency-modal.png?fit=max&auto=format&n=TbuCbl4WLlWBh-kz&q=85&s=67c3f778361bbf24114dc434868b26dc" alt="Delete a calculated field modal with dependent objects shown" width="721" height="236" data-path="_assets/images/calculated-fields/calculated-field-delete-dependency-modal.png" />
      </Frame>

6. In the confirmation modal, select **Delete**.

   <Frame>
     <img src="https://mintcdn.com/honeycomb/TbuCbl4WLlWBh-kz/_assets/images/calculated-fields/calculated-field-delete-confirmation.png?fit=max&auto=format&n=TbuCbl4WLlWBh-kz&q=85&s=01f8ab4518979dcb8a4dc792c66271dc" alt="Delete a calculated field confirmation modal" width="901" height="183" data-path="_assets/images/calculated-fields/calculated-field-delete-confirmation.png" />
   </Frame>

The screen refreshes, and the field no longer appears in the list.
Existing queries using the calculated field will still work, but the field name will no longer be available when building new queries.
