---
id: object/page/3903
type: object
title: Page 3903 "Retention Policy Setup List"
summary: Page 3903 "Retention Policy Setup List" in System Application (System.DataAdministration). Present since at least BC23, still in BC30.
tier: official
language: en
tags:
  - page
  - system application
versions:
  introduced: null
  last_changed: null
  deprecated: null
review:
  state: derived
  by: null
  at: null
  flags: []
generated:
  at: "2026-10-11T00:31:51.816Z"
  pipeline: 0.2.0
  prompts: {}
  input_hash: 8826b60e7bb70077368eca99acc63d80cc9c7440f60550a5019e1d1abafa47dd
evidence:
  - kind: code
    url: https://github.com/microsoft/BCApps/blob/ea08af5ef2d6a9b5c5af4a029288abbe2c883220/src/System%20Application/App/Retention%20Policy/src/Retention%20Policy%20Setup/RetentionPolicySetupList.Page.al
    title: src/System Application/App/Retention Policy/src/Retention Policy Setup/RetentionPolicySetupList.Page.al (releases/29.x)
    date: null
    commit: ea08af5ef2d6a9b5c5af4a029288abbe2c883220
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/admin-data-retention-policies
    title: Clean up data with retention policies
    date: null
    commit: null
    t: null
    quote: null
links:
  learn:
    - https://learn.microsoft.com/dynamics365/business-central/admin-data-retention-policies
  objects: []
  features: []
  topics:
    - topic/business-central/development-and-administration/administration-tasks-in-business-central/control-your-data
  localizations: []
  videos: []
  posts: []
  guidelines: []
object_type: page
object_id: 3903
name: Retention Policy Setup List
caption: Retention Policies
namespace: System.DataAdministration
app: System Application
extends: null
first_version: "23"
last_version: "30"
present_in:
  - "23"
  - "24"
  - "25"
  - "26"
  - "27"
  - "28"
  - "29"
  - "30"
changed_in: []
source_major: "29"
obsolete: null
countries: []
ms_search_form_ids:
  - docs/learn-smb-docs/business-central/admin-data-retention-policies.md
counts:
  fields: 0
  procedures: 0
  events: 0
  subscribers: 0
  controls: 6
  actions: 5
relations:
  out: 2
  referenced_by: 0
  pages: 0
  extended_by: 1
  event_subscribers: 0
  calls: 2
  called_by: 0
  implements: 0
---

# Page 3903 "Retention Policy Setup List"

> Page 3903 "Retention Policy Setup List" in System Application (System.DataAdministration). Present since at least BC23, still in BC30.

System Application · System.DataAdministration · captioned "Retention Policies" · BC23-30 · [source at ea08af5e](https://github.com/microsoft/BCApps/blob/ea08af5ef2d6a9b5c5af4a029288abbe2c883220/src/System%20Application/App/Retention%20Policy/src/Retention%20Policy%20Setup/RetentionPolicySetupList.Page.al) · facts from BC29

## Properties

| Property | Value |
|---|---|
| Caption | Retention Policies |
| SourceTable | Retention Policy Setup |
| PageType | List |
| UsageCategory | Administration |
| ApplicationArea | All |

## Fields on this page

Layout controls in source order, grouped by the container they sit in. Shows: the table field a control is bound to (or its expression as written); ToolTip: the control's own, else the bound field's (marked).

| Group | Control | Shows | ToolTip |
|---|---|---|---|
| GroupName | Table ID | [Table Id](../table/3901.md#fields) | Specifies the ID of the table to which the retention policy applies. |
|  | Table Name | [Table Name](../table/3901.md#fields) | Specifies the name of the table to which the retention policy applies. |
|  | Table Caption | [Table Caption](../table/3901.md#fields) | Specifies the caption of the table to which the retention policy applies. The caption is the translated, if applicable, name of the table. |
|  | Enabled | [Enabled](../table/3901.md#fields) | Specifies whether the retention policy is enabled. |
|  | Manual | [Manual](../table/3901.md#fields) | Specifies whether the retention policy can only be run manually. |
|  | Retention Period | [Retention Period](../table/3901.md#fields) | Specifies an identifier for the retention period. |

## Actions

| Group | Action | ToolTip | Runs |
|---|---|---|---|
| Navigation | Retention Periods | Set up retention periods. | [Page 3900 "Retention Periods"](../page/3900.md) |
|  | Retention Policy Log | View activity related to retention policies. | [Page 3904 "Retention Policy Log Entries"](../page/3904.md) |
| Processing | Apply Manually | Apply the retention policy and delete all expired records in the table. |  |
|  | Apply All | Apply all non-manual and enabled retention policies now and delete any expired records. |  |
|  | Refresh Allowed Tables | Refreshes the list of tables that can be selected. |  |

## Triggers

OnOpenPage

## Relations

- card page [Page 3901 "Retention Policy Setup Card"](../page/3901.md)
- source table [Table 3901 "Retention Policy Setup"](../table/3901.md)

## Extended by

- [Page extension 3999 "Reten. Pol. Setup List Ext."](../pageextension/3999.md)

## Calls

From the extracted call graph of BC29 (graphify-al on the snapshot checkout): calls whose target is known from a declared type or an `Object::"Name"` argument. Interface dispatch and calls through events are not counted, so the list is not complete.

- [Codeunit 3905 "Reten. Pol. Allowed Tables"](../codeunit/3905.md) (1 call: `OnOpenPage → OnRefreshAllowedTables`)
- [Codeunit 8703 "Feature Telemetry"](../codeunit/8703.md) (1 call: `OnOpenPage → LogUptake`)

## Across versions

- Present in: BC23-30
- Changed (declaration) in: none

## Documented on Microsoft Learn

- [Clean up data with retention policies](https://learn.microsoft.com/dynamics365/business-central/admin-data-retention-policies)

Source: AL metadata extracted from the code (names, ids, signatures, properties); no code bodies (D10).

## Ask your agent

Procedure bodies are not stored here (D10). The call sections above are our own, per object, from the BC29 call graph. For a procedure body or the calls of one procedure, ask bc-code-atlas (external, by Stefan Maron, MIT; default corpus w1-28), which the bc-observatory plugin connects: `bcatlas_resolve_node(object_type: "page", object_name: "Retention Policy Setup List")`, then `bcatlas_get_procedure_body` or `bcatlas_get_neighbors` on the returned id.
