---
title: "Configuring Letters"
slug: "configuring-letters"
updated: 2025-07-02T13:35:01Z
published: 2025-07-02T13:35:01Z
canonical: "help.iobeya.com/configuring-letters"
---

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

# Configuring Letters

In this article, discover how to configure a letter to suit your needs: adjust its settings and properties.

> [!WARNING]
> Warning:
> 
> Only Room administrator can access the items described in this article.

![Parametrage lettre QCD](https://cdn.document360.io/e61a3dcb-bae0-4a4f-820c-85b0f6ef7f3c/Images/Documentation/Parametrage%20lettre%20QCD.gif)

## Accessing the Letter Settings Screen

You can access the letter configuration screen in two ways:

- During their creation: select the letter you want to configure and drag and drop it onto the board.
- Through the element's [contextual menu](/product/docs/about-contextual-menu-actions): click **Settings**.

As a Room administrator, you can modify all the properties of a letter.

![QCD - paramétrage lettre 2](https://cdn.document360.io/e61a3dcb-bae0-4a4f-820c-85b0f6ef7f3c/Images/Documentation/QCD%20-%20param%C3%A9trage%20lettre%202.png)

This settings interface is divided into 3 parts:

1. [**Indicators setting**](/product/docs/configuring-letters#setting-indicators): allows to define the various indicators associated with the letter. Specify their thresholds, values, etc.
2. [**Ring & color-coding settings**](/product/docs/configuring-letters#setting-rings): allows to configure rings, the letter's color-coding, to visually highlight information related to indicators and actions.
3. [**Letter parameters**](/product/docs/configuring-letters#letter-parameters): allows to edit the letter's global properties: rename the letter, enter a group and enter a description.

> [!NOTE]
> Note:
> 
> If you have editing permissions for the board, you can access the letter configuration and view all the settings defined by the room administrator.
> 
> However, the following restrictions apply:
> 
> - No change in indicators,
> - No modification of the description,
> - Restricted edition of rings: if the ring has a custom cut-out, you can only modify the box labels.

## Setting Rings

This setting depends on the [number of rings defined in the tool and their parameters](/product/docs/configure-the-qcd-letter-tool-in-the-dock#defining-the-number-of-rings-and-the-cutout-types).

> [!NOTE]
> Note:
> 
> You can set parameters for each ring defined.

#### Cut-out Type: Temporal

From the “Ring(temporal) and color-coding” area:

![QCD - paramétrer cercles 1(1)](https://cdn.document360.io/e61a3dcb-bae0-4a4f-820c-85b0f6ef7f3c/Images/Documentation/QCD%20-%20param%C3%A9trer%20cercles%201(1).png)

1. Click **Set up the outer ring**.

The following screen is displayed:

![QCD - paramétrer cercles 2](https://cdn.document360.io/e61a3dcb-bae0-4a4f-820c-85b0f6ef7f3c/Images/Documentation/image-1732633998862.png)
2. Enter the ring name.

> [!NOTE]
> Note:
> 
> You can find this name in the definition of the indicators, in the filters of the other tools, in the legend of the letter
3. Declare non-working days if necessary.

> [!NOTE]
> Note:
> 
> Automatically turns Saturday and/or Sunday boxes gray according to the current short term time window.
4. Select the [box color-coding](/product/docs/configuring-letters#box-colorcoding):

> [!NOTE]
> Note:
> 
> This action defines how the letter's boxes are colored.

You can specify whether the user is prompted for an action.
  - [Manual](/product/docs/configuring-letters#manual)
  - [Global threshold](/product/docs/configuring-letters#global-threshold)
  - [Single thresholds](/product/docs/configuring-letters#single-thresholds)
  - By default, action creation pop ups are set in the box on the right.
5. When you return to the “Ring(temporal) and valuation” area, you can add a new ring if required. To do so:

> [!WARNING]
> Warning:
> 
> You cannot edit the ritual frequency afterwards.
  1. Enable the “Activate new circle” toggle.
  2. Select the ritual frequency.
  3. Click **Save**.

#### Cut-out Type: Custom

From the “Ring(custom) and color-coding” area:

![QCD - paramétrer cercles 3](https://cdn.document360.io/e61a3dcb-bae0-4a4f-820c-85b0f6ef7f3c/Images/Documentation/image-1732634669538.png)

1. Click **Set up the outer ring**.

The following screen is displayed:

![QCD - paramétrer cercles 4](https://cdn.document360.io/e61a3dcb-bae0-4a4f-820c-85b0f6ef7f3c/Images/Documentation/image-1732634720139.png)
2. Enter the ring name.

> [!NOTE]
> Note:
> 
> You can find this name in the definition of the indicators, in the filters of the other tools, in the legend of the letter.
3. Configure cut-out: enter box labels (5 characters maximum).

> [!NOTE]
> Note:
> 
> Allows you to define the text that is displayed in each box.
4. Select the [box color-coding](/product/docs/configuring-letters#box-colorcoding):

> [!NOTE]
> Note:
> 
> This action defines how the letter's boxes are colored.

You can specify whether the user is prompted for an action.
  - Manual
  - Global threshold
  - Single thresholds
  - By default, action creation pop ups are set in the box on the right.

### Enabling a New Ring

> [!WARNING]
> Warning:
> 
> This feature is only available for temporal cut-out.

1. From your board, click the letter in which you want to add a ring.
2. From the contextual menu, Click **Settings**.
3. Click **Activate a new ring**.![QCD - paramétrer cercles 5](https://cdn.document360.io/e61a3dcb-bae0-4a4f-820c-85b0f6ef7f3c/Images/Documentation/QCD%20-%20param%C3%A9trer%20cercles%205.png)
4. Select a ritual frequency.
5. Click **Save**.

> [!NOTE]
> Note:
> 
> The ring(s) already configured cannot be moved on the letter. The new ring is automatically added to the external side of the letter.

### Showing or Hiding a Ring

> [!WARNING]
> Warning:
> 
> This feature is only available for temporal cut-out.

1. From your board, click the letter in which you want to edit.
2. From the contextual menu, Click **Settings**.
3. Click on the toggle associated to the ring you want to show or to hide.

![QCD - paramétrer cercles 6](https://cdn.document360.io/e61a3dcb-bae0-4a4f-820c-85b0f6ef7f3c/Images/Documentation/QCD%20-%20param%C3%A9trer%20cercles%206.png)
4. Click **Save**.

### Box Color-Coding

#### **Manual**

![QCD - type de valorisation manuelle](https://cdn.document360.io/e61a3dcb-bae0-4a4f-820c-85b0f6ef7f3c/Images/Documentation/QCD%20-%20type%20de%20valorisation%20manuelle.png)

The user manually indicates the box color during the ritual.

For each available color (depends on the Platform configuration restricted to green orange and red), you, as administrator, can specify whether the user is prompted an action.

- By default, action creation pop ups are set in the box on the right.

#### **Single thresholds**

![QCD - type de valorisation par seuil (indicateur)](https://cdn.document360.io/e61a3dcb-bae0-4a4f-820c-85b0f6ef7f3c/Images/Documentation/QCD%20-%20type%20de%20valorisation%20par%20seuil%20(indicateur).png)

The indicator with the warmest color sets the box color:

- If at least one indicator is red, the box will be red.
- Otherwise, if at least one indicator is orange, the box will be orange (depending on platform settings).
- Otherwise, if at least one indicator is green, the box will be green.

For this type of color coding, boxes are given a color based on single rules defined for each indicator.

#### **Global Threshold**

![QCD - type de valorisation par seuil global](https://cdn.document360.io/e61a3dcb-bae0-4a4f-820c-85b0f6ef7f3c/Images/Documentation/QCD - type de valorisation par seuil global(1).png)

The sum or the avergage of the indicators set the box color, depending on the global threshold.

For this type of color coding, you have to explicitly define a rule: click **Settings**.

This rule is based on the following elements:

![QCD - type de valorisation par seuil global paramètres](https://cdn.document360.io/e61a3dcb-bae0-4a4f-820c-85b0f6ef7f3c/Images/Documentation/QCD%20-%20type%20de%20valorisation%20par%20seuil%20global%20param%C3%A8tres.png)

1. Calculation method, that can be:
  - the sum
  - the average of the indicator values
2. 1 or 2 thresholds depending on the Platform configuration
3. Formula, that defines box color by comparing indicator sum or average to threshold(s)
4. Action creation pop-up that you can trigger from a formula including all indicators or from a formula defined for a single indicator

### Color-Coding Icons

| Ring color-coding | Ring color-coding icons | Indicator color-coding icons |
| --- | --- | --- |
| [**Manual**](/product/docs/configuring-letters#box-colorcoding) | ![QCD - type de valorisation manuelle - symbole](https://cdn.document360.io/e61a3dcb-bae0-4a4f-820c-85b0f6ef7f3c/Images/Documentation/QCD%20-%20type%20de%20valorisation%20manuelle%20-%20symbole.png) The dot under each color indicates whether you have [defined an action proposal](/product/docs/configuring-letters#using-the-suggested-action). | ![QCD - picto indicateur - manuelle](https://cdn.document360.io/e61a3dcb-bae0-4a4f-820c-85b0f6ef7f3c/Images/Documentation/image-1732631920000.png) |
| [**Global threshold**](/product/docs/configuring-letters#box-colorcoding) - Action creation pop-up for local actions | - If you enable the “action proposal rule” toggle: ![QCD - type de valorisation par seuil (global) - symbole avec règle de propostion d'action](https://cdn.document360.io/e61a3dcb-bae0-4a4f-820c-85b0f6ef7f3c/Images/Documentation/QCD%20-%20type%20de%20valorisation%20par%20seuil%20(global)%20-%20symbole%20avec%20r%C3%A8gle%20de%20propostion%20d'action.png) - In the case of an average calculation method, the following icon is displayed: ![QCD - type de valorisation par seuil (global) - moyenne des indicateurs](https://cdn.document360.io/e61a3dcb-bae0-4a4f-820c-85b0f6ef7f3c/Images/Documentation/QCD%20-%20type%20de%20valorisation%20par%20seuil%20(global)%20-%20moyenne%20des%20indicateurs.png) | - If you enable the “action proposal rule” toggle: ![QCD - picto indicateur - seuil global](https://cdn.document360.io/e61a3dcb-bae0-4a4f-820c-85b0f6ef7f3c/Images/Documentation/QCD%20-%20picto%20indicateur%20-%20seuil%20global.png) The formula and threshold arel not used. |
| [**Global threshold**](/product/docs/configuring-letters#box-colorcoding) - No local action creation pop-up | If you do not enable the “action proposal rule” toggle: ![QCD - type de valorisation par seuil (global) - symbole](https://cdn.document360.io/e61a3dcb-bae0-4a4f-820c-85b0f6ef7f3c/Images/Documentation/QCD%20-%20type%20de%20valorisation%20par%20seuil%20(global)%20-%20symbole.png) | If you do not enable the “action proposal rule” toggle: ![QCD - picto indicateur - seuil global - pas de proposition d'action locale](https://cdn.document360.io/e61a3dcb-bae0-4a4f-820c-85b0f6ef7f3c/Images/Documentation/QCD%20-%20picto%20indicateur%20-%20seuil%20global%20-%20pas%20de%20proposition%20d'action%20locale.png) |
| [**By threshold (indicator)**](/product/docs/configuring-letters#box-colorcoding) | None | ![QCD - picto indicateur - seuil indicateur](https://cdn.document360.io/e61a3dcb-bae0-4a4f-820c-85b0f6ef7f3c/Images/Documentation/QCD%20-%20picto%20indicateur%20-%20seuil%20indicateur.png) All the properties of the rules are used. |

## Setting Indicators

> [!NOTE]
> Note:
> 
> You can define up to 10 different indicators per ring.

To define an indicator associated with your letter, click **+New indicator.**

![QCD - paramétrage indicateurs 2](https://cdn.document360.io/e61a3dcb-bae0-4a4f-820c-85b0f6ef7f3c/Images/Documentation/image-1732639085518.png)

The **Indicator settings** screen is displayed:

![QCD - paramétrage indicateurs 1](https://cdn.document360.io/e61a3dcb-bae0-4a4f-820c-85b0f6ef7f3c/Images/Documentation/QCD%20-%20param%C3%A9trage%20indicateurs%201.png)

1. **Generic properties**:
  1. Enter:
    - name (40 characters maximum).
    - unit of measurement (3 characters maximum).
  2. Select a color.
  3. If you [define more than one ring](/product/docs/configure-the-qcd-letter-tool-in-the-dock#defining-the-number-of-rings-and-the-cutout-types), select the ring(s) that contain(s) this indicator.

> [!NOTE]
> Note:
> 
> If you do not define any rings, the indicator is created by default in the outer ring.
2. **“Mandatory indicator” toggle** : if a mandatory indicator is given no value, the ring it belongs to are not color coded if its color coding type is set on [single thresholds](/product/docs/configuring-letters#single-thresholds).
3. **Value entry mode**:
  1. Select the valuation mode for your indicator:
    - **Free**: threshold value entry type, with on 1 or 2 thresholds![QCD - paramétrage indicateurs 3](https://cdn.document360.io/e61a3dcb-bae0-4a4f-820c-85b0f6ef7f3c/Images/Documentation/QCD%20-%20param%C3%A9trage%20indicateurs%203.png)

If you select this value entry mode, you can define thresholds per box. To do this:
      1. Enable the “Thresholds per box” toggle.
      2. Click **Set the thresholds per box**.
      3. Enter the threshold values for each box. You need to enter them for each time sequence (weekly, monthly, etc.).

> [!NOTE]
> Note:
> 
> If you definemore than on ring, enter the threshold values for each box in each ring.
      4. Confirm your entry.
    - **Binary**: Binary value entry type, with the indicator bearing 2 values only (its use is based on a state.).

![QCD - paramétrage indicateurs 4](https://cdn.document360.io/e61a3dcb-bae0-4a4f-820c-85b0f6ef7f3c/Images/Documentation/image-1732639847849.png)

> [!NOTE]
> Note:
> 
> - Changing the State fields in the binary valuation mode only affects the button label, its value does not change.
> - The values used for the binary valorization mode are always 0 and 1. The value 0 is on the left.
> - During [consolidation](/product/docs/consolidating-your-indicators-in-qcd), only the values of the buttons (0 and 1) are used.
4. Define the box color-coding: use [indicators thresholds](/product/docs/configuring-letters#using-indicators-thresholds).
5. Confirm your indicator.

See [Inputting your indicators](/product/docs/inputting-your-indicator-values) to find out more about how to input indicator values on the letter.

### Using Indicators Thresholds

The indicator thresholds allow you to define box color-coding based on 1 or 2 thresholds.

![](https://cdn.document360.io/e61a3dcb-bae0-4a4f-820c-85b0f6ef7f3c/Images/Documentation/QCD - formules de calcul 3.png)

**Case of **1 threshold****

In the case where you use **1 threshold**, you need to define 3 colors:

![QCD - formules de calcul](https://cdn.document360.io/e61a3dcb-bae0-4a4f-820c-85b0f6ef7f3c/Images/Documentation/QCD%20-%20formules%20de%20calcul.png)

1. The one displayed if the value entered in the box is below the threshold.
  - By default, the box is green.
2. The one displayed if the value entered in the box is equal to the threshold.
  - By default, the box is green.
3. The one displayed if the value entered in the box is greater than the threshold.
  - By default, the box is red.

Click on one of the blocks to select the color.

**Cas de **2 thresholds****

In the case where you use **2 thresholds**, you need to define 3 colors:

![QCD - formules de calcul 2](https://cdn.document360.io/e61a3dcb-bae0-4a4f-820c-85b0f6ef7f3c/Images/Documentation/QCD%20-%20formules%20de%20calcul%202.png)

1. The one displayed if the value entered in the box is below the lower threshold.
  - By default, this color is green.
2. The one displayed if the value entered in the box is equal to the lower threshold.
  - By default, this color is green.
3. The one displayed if the value entered in the box is between the lower and higher thresholds.
  - By default, this color is orange if available, red otherwise.
4. The one displayed if the value entered in the box is equal to the higher threshold.
  - By default, this color is orange if available, red otherwise.
5. The one displayed if the value entered in the box is greater than the higher threshold.
  - By default, this color is red.

Click on one of the blocks to select the color.

> [!NOTE]
> Note:
> 
> In case of 2 thresholds:
> 
> - The second threshold must be greater than the first threshold.
> - If the first threshold is defined, then second one has to be defined as well.

### Using the Suggested Action

Regardless of the type of color coding of a ring or the color of a single box, the system may ask you to take an action.

- As an administrator, you can specify whether your team are prompted to take an action. When you select the color of an indicator, you can choose to propose an action: check the associated box.

![QCD - proposition d'action](https://cdn.document360.io/e61a3dcb-bae0-4a4f-820c-85b0f6ef7f3c/Images/Documentation/QCD%20-%20proposition%20d'action.png)
  - By default, action creation pop ups are set in the box on the right.
- For other color-coding types, you can define whether or not an action are proposed. An indicator is displayed on the block if the answer is Yes.

## Letter Parameters

From the **Letter Parameters** screen, you can change/set the following parameters:

![QCD - paramétrer la lettre](https://cdn.document360.io/e61a3dcb-bae0-4a4f-820c-85b0f6ef7f3c/Images/Documentation/QCD%20-%20param%C3%A9trer%20la%20lettre.png)

- **Letter name:** You can edit it after you add it to the board. The new name is displayed at the top left of the letter.

> [!WARNING]
> Warning:
> 
> You cannot edit the letter character defined in the dock once the letter is added to the board.
- **Group:** Parameter allows to filter your letters by groups from the indicator entry.
- **Description**: Description of your letter that is displayed at the top right of the letter.

User with elevated permissions responsible for managing and configuring a specific room. This role includes tasks such as adding or removing boards, managing users' access and permissions within the room, customizing the room’s layout, and standardizing visual management practices. The room administrator ensures that the team uses visual management in accordance with established guidelines and best practices.