Workflow auto purge leaves empty folders in AEMaaCS

In AEMaaCS, running the workflow auto purge feature deletes workflow instance nodes as expected, but empty container folders under /var/workflow/instances remain. These folders follow a server- and date-based structure and persist after the purge. This behavior is by design and does not affect repository health or performance. To fix this, verify the purge behavior and understand why these empty folders remain.

Description description

Environment

  • Product: Adobe Experience Manager as a Cloud Service – Sites
  • Configuration: Workflow auto purge with scheduledpurge.purgePackagePayload=true

Issue/Symptoms

  • Workflow instance nodes are deleted after running the workflow auto purge job.
  • Parent container folders such as /var/workflow/instances/<server>/<date> remain in the repository.
  • The remaining folders exist as empty sling:Folder nodes.

Resolution resolution

To handle empty workflow instance folders after auto purge, follow these steps:

  1. Confirm that the workflow auto purge job deletes workflow instance nodes according to your configuration.

  2. Check the /var/workflow/instances path and observe that empty server- and date-based container folders remain. Notes:

    • Understand that these empty folders are expected and serve as an organizational structure for workflow instances.
    • Take no further action, because there is no out-of-the-box setting to remove these folders automatically.
    • If folder removal is required, implement a custom solution in your codebase outside standard product configuration.
  3. Verify that only workflow instance nodes are deleted and that package payloads under /var/workflow/packages follow your configured purge settings.

Notes:

  • The scheduledpurge.purgePackagePayload setting applies only to packages under /var/workflow/packages (or /etc/workflow/packages in older setups) and does not affect container folders under /var/workflow/instances.
  • Empty sling:Folder nodes have minimal impact on storage usage and system performance.
  • AEMaaCS does not provide a built-in mechanism to automatically remove these empty organizational folders.
recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f