---
title: "Viewing Long-Term Retention Policy"
description: "To view the long-term retention policy defined for the backup job, use the following command: or where: <job_id> — ID of the backup job for which you want to view the long-term retention policy."
canonical: "https://helpcenter.veeam.com/docs/agentformac/userguide/backup_job_cmd_gfs_show.html"
breadcrumb: "User Guide > Performing Backup > Creating Backup Jobs > Creating Backup Job in Command Line Interface > Configuring Long-Term Retention Policy > Viewing Long-Term Retention Policy"
dateModified: "2026-10-20"
---

# Viewing Long-Term Retention Policy

To view the long-term retention policy defined for the backup job, use the following command:

```
veeamconfig gfs show --jobid <job_id>
```

or

```
veeamconfig gfs show --jobname <job_name>
```

where:

- `<job_id>` — ID of the backup job for which you want to view the long-term retention policy.
- `<job_name>` — name of the backup job for which you want to view the long-term retention policy.

Veeam Agent displays the following information about the backup job long-term retention policy:

<table style="width:100%;" class="Blue_Table">
  <tr style="vertical-align:top">
    <th style="vertical-align:middle; width:20%;">
      <p>Parameter</p>
    </th>
    <th style="vertical-align:middle;">
      <p>Description</p>
    </th>
  </tr>
  <tr style="vertical-align:top">
    <td style="vertical-align:top; width:20%;">
      <p><span style="font-weight:bold;">GFS state</span></p>
    </td>
    <td style="vertical-align:top;">
      <p>State of long-term retention policy. Possible values:</p>
      <ul>
        <li class="Table_List">GFS is enabled</li>
        <li class="Table_List">GFS is disabled</li>
        <li class="Table_List">GFS is not set</li>
      </ul>
    </td>
  </tr>
  <tr style="vertical-align:top">
    <td style="vertical-align:top; width:20%;">
      <p><span style="font-weight:bold;">Enabled</span></p>
    </td>
    <td style="vertical-align:top;">
      <p>Possible values: <span class="T_Filenames">true</span> or <span class="T_Filenames">false</span>.</p>
    </td>
  </tr>
  <tr style="vertical-align:top">
    <td style="vertical-align:top; width:20%;">
      <p><span style="font-weight:bold;">Desired time</span></p>
    </td>
    <td style="vertical-align:top;">
      <p>Weekday, week number or month when Veeam Agent will set the GFS flag on the full restore point.</p>
    </td>
  </tr>
  <tr style="vertical-align:top">
    <td style="vertical-align:top; width:20%;">
      <p><span style="font-weight:bold;">Keep for</span></p>
    </td>
    <td style="vertical-align:top;">
      <p>Period of time for retaining the GFS flag on the full restore point.</p>
    </td>
  </tr>
</table>

The information listed in the table above is displayed for weekly, monthly and yearly retention policies.

For example:

```
user@wrk01:~$ veeamconfig gfs show --jobid 4849a3ae-1935-4969-98a3-d8acd2f6c73f 
GFS is enabled
Weekly:
  Enabled: true
  Desired time: Friday
  Keep for: 1 weeks
Monthly:
  Enabled: false
  Desired time: First
  Keep for: 1 months
Yearly:
  Enabled: false
  Desired time: January
  Keep for: 1 years
```