Retention Period

The Retention Period feature allows you to define how long Appcircle should retain artifacts generated by different modules : Build, Testing Distribution, Publish to Stores, and Enterprise App Store.

Overview

• Starter Organizations use default retention settings and cannot modify retention rules.
  By default, all artifacts are automatically removed every month.

• Enterprise Organizations can fully customize the retention rules for each module.
  Available retention periods include:

  • 1 week
  • 1 month
  • 2 months
  • 3 months
  • 6 months
  • 1 year
  • 2 years
  • Never delete

Build Module

The Build section provides advanced artifact cleanup rules:

Delete Successful Build Artifacts

Automatically removes artifacts generated from successful builds that are older than the configured retention period.

Delete Failed Build Artifacts

Deletes artifacts produced by failed builds that exceed the retention period.

Delete Artifacts Matching the Keyword

Removes build artifacts that contain a specific file extension in their name.
Example: .ipa, .apk, .txt

Keep Artifacts Matching the Keyword

Preserves build artifacts that match specific file extention.
Example: Keep all .ipa files while deleting other formats.

Build Retention Rules

• Delete Artifacts Matching the Keyword and Keep Artifacts Matching the Keyword cannot contain the same values.
• Both fields cannot be empty at the same time, Appcircle will not delete any build artifacts.
• Delete Artifacts Matching the Keyword setting cannot be empty.
• Only Keep Artifacts Matching the Keyword can be empty if you would like to delete all build artifacts or just some specific file types.

Build Activity Log

Artifacts that were deleted by the Retention Period actions will also be displayed within the Build Activity Log.

Testing Distribution

The Testing Distribution module retention rules include:

Delete Distributed Artifacts

Automatically removes distributed artifacts that are older than the configured retention period.

Delete Undistributed Artifacts

Automatically deletes undistributed artifacts that exceed the defined retention period.

Publish to Stores

Publish to Stores module includes specific rules for artifacts:

Delete Publish Module Artifacts

Automatically deletes artifacts within the Publish to Stores module profiles that are older than the retention period.

Keep if Marked as RC

When enabled, preserves artifacts marked as Release Candidate (RC) even if they exceed the retention period.

Keep if Published to Store

Retains artifacts already released to stores such as:

• Apple App Store
• Google Play Store
• Huawei AppGallery
• Microsoft Intune

Enterprise App Store

The Enterprise App Store module supports the following retention rule:

Delete Enterprise App Store Artifacts

Automatically deletes Enterprise App Store artifacts that exceed the configured retention period.

info

Artifacts already published to the Enterprise Portal via Beta or Live channels are not deleted, even if they surpass the defined retention period.

tip

If an app version with an upload date that exceeds the allowed retention period was recently unpublished from Enterprise Portal channels, it will not be deleted, as it was previously used in the Portal within the allowed retention period.

Artifacts Reports

The Artifacts Reports section provides a detailed overview of artifacts that were automatically deleted based on your configured Retention Period rules. It will also display the artifacts that were manually deleted by the users.

This report helps organizations monitor and verify which artifacts have been removed, when the deletion occurred, and which rule or trigger caused it.

Overview

Each row in the report represents a deleted artifact and includes key details such as:

Column	Description
Org Name	Displays the organization name that owned the deleted artifact.
Module	Indicates which Appcircle module the artifact belonged to — Build, Testing Distribution, Publish to Stores, or Enterprise App Store.
File Type	Shows the type of file deleted (e.g., .ipa, .apk, .png).
Size	Displays the original size of the deleted artifact.
Rule	Describes the applied retention rule (e.g., excluding RC, excluding sent-to-store, delete failed builds, etc.).
Days	Indicates the configured retention period for that rule (e.g., 1 month, 6 months).
Description	Provides the name or description of the deleted artifact for easy identification.
Physically Delete	Shows whether the artifact was permanently deleted from storage.
Triggered By	Shows the user email address that deleted the artifact. If it was an automatic process, it would display 'System' .
Job Triggered By	Specifies the retention job type —
Delete At	Displays the exact timestamp when the deletion occurred.

Filtering Options

You can use the filtering tools at the top of the report to narrow down results:

• Filter by Date — View deleted artifacts within a specific time frame (e.g., Last 7 Days, Last Month).
• Filter by Module — Focus on deletions from a particular module such as Build, Publish to Stores, or Enterprise App Store.
• Filter by Organization — Display deleted artifacts for your root organization or sub-organizations.