The Data Expiration feature helps organizations manage data retention by allowing you to view and change the remaining time until stored data is deleted.
You can configure this feature globally or per organization to meet compliance and storage requirements.
Daily use of Cognigy products resets the data retention countdown, keeping your data from expiring.
For example, if the data expiration is set to 30 days and a user sends a message on May 1, the data will be retained until May 31; if they send another message on May 15, the expiration shifts to June 14.
Key Benefits
- Improved Data Compliance. Helps organizations follow laws and regulations by automatically deleting data after a set retention period.
- Optimized Storage Management. Prevents unnecessary data buildup by removing expired data, which lowers storage costs and keeps the system running smoothly.
- Flexible Configuration for SaaS and On-Premises. Allows you to set data expiration rules globally or individually for each organization, whether you use SaaS or on-premises installations.
How to Use
Activate Data Expiration
By default, Cognigy.AI keeps analytics data to a maximum of 1 year. You can reduce this data expiration period as follows:- For on-premises installations and dedicated SaaS installations, set data expiration values in the Management UI.
- For shared SaaS installations, contact Cognigy technical support and specify the limits in your request.
Example
Example
You set a 1-minute expiration value at 13:00 for Sessions in the Management UI.All Sessions created after 13:00 will automatically expire after 1 minute.Sessions created before 13:00 will remain unchanged.
Check when Data Expires
To check when data expires, click
in the upper-right corner of the Insights interface.
To view the exact time in minutes, hover over the displayed value.
The table shows the data from the Analytics database covered by data expiration and illustrates how they map to the data displayed in reports and explorers.
With Cognigy.AI 4.91, the Understood Messages concept was deprecated, with removal from the Insights reports scheduled for version 2025.19. Use the Goals and Tasks concepts to evaluate whether your AI Agent understood a particular phrase.Respectively, the OData endpoint
understood field was deprecated in the same version, with full removal scheduled for version 2025.24. Use the Goals collection in the Cognigy.AI OData endpoint.Refer to the list of all upcoming removals on the Deprecations and Removals page.View the table
View the table
| Data | Description | Reports and Explorers |
|---|---|---|
| Analytics | The time span between the creation of all Analytics data and its deletion from the Analytics database. | Overview: - Number of Inputs - Top Intents Engagement: - Avg. Session Length - Max. Session Length NLU Performance: - Avg Intent Score - Average Execution Time - Intents by Score Range - Max Intent Score - Top Intents - Top Intent Scores |
| Conversations | The time span between the creation of chat history analytics and its deletion from the database. | Transcript Explorer, Message Explorer |
| Sessions | The time span between the creation of Insights session analytics and its deletion from the database. | Overview: - Active Sessions - Positive Ratings - Sessions - Session by Channel - Total Sessions - Top Tasks - Top Slots - Unique Contacts - Users by Locale Engagement: - Contacts - Goals Reached - Handovers by time of the day - Live Agent Escalations - Positive Ratings - Positive Ratings over Time NLU Performance: - Top Slots |
| Step Events | The time span between the creation of Step data and its deletion from the database. | Step Explorer |
| LiveAgentEscalation | The time span between the creation of Live Agent data and its deletion from the database. | Live Agent |
| voice-gatewayEvents | The time span between the creation of Voice Gateway data and its deletion from the database. | - |
| GoalsV2Events | The time span between the creation of Goals data and its deletion from the database. | Goals |
Change Data Expiration
You can change data expiration values as follows:- For on-premises Cognigy.AI installations, you can adjust data expiration values via the Management UI.
- For SaaS installations, contact technical support.
Customize Data Expiration for Multiple Organizations
If you manage multiple organizations, you can customize the data expiration settings for each organization independently through the Management UI. The default data expiration value is set in the environment variable in thevalues.yaml file.
The Management UI value can override the environment variable for an organization.
This override happens only if the Management UI value is positive and less than the environment variable.This setup balances global defaults with organization-specific requirements.