# Ativo Program fields use PI keys since April 2023

{% hint style="info" %}
You can opt-out of this change by enabling [field sharing](https://docs.ativo.io/advanced/ativo-programs-custom-fields/field-sharing).
{% endhint %}

### Why change?

In our previous data model, data was saved with the period key only. This caused limitations when features are used in multiple program increments on the same period. To solve this problem, we have to change the way data is saved on the Ativo Programs fields in Jira.

### What changes?

The way how the following [Ativo Programs fields](https://docs.ativo.io/advanced/ativo-programs-custom-fields) are formatted, changes:

* **Program team**\
  \
  An entry is now formatted as `Programkey-PeriodKey-TeamKey` . Example: `PGRM1-2024Q1-TEAMLION`<br>
* **Program period**\
  \
  An entry is now formatted as `Programkey-PeriodKey` . Example: `PGRM1-2024Q1`<br>
* **Program Baseline Sprint**\
  \
  An entry is now formatted as `Programkey-PeriodKey.SprintId` . Example: `PGRM1-2024Q1.2`<br>
* **Program Commitments**\
  \
  An entry is now formatted as `Programkey-PeriodKey-CommitmentLevel`. Example: `PGRM1-2024Q1-committed`

### Gradual change

Data will only be updated to the new format when taking an action in Ativo Programs (e.g. updating a team in the lead in Ativo). Entries using the old data format will be gradually replaced with new entries..

There is hence no bulk data migration needed.

Ativo Programs continues to accept the old data format. If an Ativo Programs field contains both entries in the new and old data format, entries in the new data format will take precedence.

### Impacts for users?

**There is no impact for users that work in Ativo Programs**. The change is not visible in the UI itself.

There is an impact for power users who:

* Use Ativo Programs fields directly in Jira filters / reports. Those users need to change their JQL queries to include the new data format.\
  \
  Example:  the old `"Program Period[Labels]" = 2023Q1` JQL query would first become `"Program Period[Labels]" in (2023Q1, PROGRAMONE-2023Q1)` to include the program increment key(s) (program key + period key combined) instead. Over time, only the new keys would be needed. E.g. `"Program Period[Labels]" = PROGRAMONE-2023Q4`.<br>
* Build automation scripts using Ativo data. They will need to update the way data is read or updated according to the new format.&#x20;

### When change?

The above changes are effective on **April 23rd 2023** (on the Jira cloud platform), and after installing Ativo Programs **version 3.1** (Jira Server / Data Center platform).&#x20;

More questions? Contact [Ativo support](https://www.ativo.io/contact).