Data Retention

How to configure data retention policies, automatic deletion, and data export in BttrForm for compliance.

7 min read

Data retention policies define how long BttrForm stores your data and what happens when that period expires. Proper data retention is not just good housekeeping -- it is a requirement of compliance frameworks like GDPR, HIPAA, and SOC 2. BttrForm gives you the controls to configure retention policies that match your regulatory obligations and business needs.

Default Retention Policies

By default, BttrForm retains data indefinitely unless you configure a specific retention policy. This means form responses, file uploads, and account data remain in the system until you manually delete them or set up an automated retention policy.

Data TypeDefault RetentionNotes
Form responsesIndefiniteUntil manually deleted or retention policy applied
File uploadsIndefiniteStored in encrypted object storage
Audit logs365 days minimumRequired by SOC 2; configurable up to 7 years
Account dataUntil account deletionProfile, settings, preferences
Analytics data90 days (detailed), 2 years (aggregated)Detailed events auto-aggregate after 90 days
Session data24 hours after expiryAutomatically cleaned up
Deleted form data30 days (soft delete)Recoverable during soft delete window

No Surprise Deletions

BttrForm never deletes your data without your explicit configuration. Default retention is indefinite, so your data is preserved until you decide otherwise.

Configuring Retention Policies

You can set retention policies at the organization level or per individual form.

Organization-Level Retention

  1. Navigate to Settings > Compliance > Data Retention.
  2. Set the default retention period in days. This applies to all forms that do not have a form-specific policy.
  3. Choose what happens when data expires:
    • Delete permanently -- Data is irrecoverably removed.
    • Archive -- Data is moved to cold storage (accessible on request, not visible in dashboard).
  4. Save your settings.

Form-Level Retention

Individual forms can override the organization default:

  1. Open the form in the form builder.
  2. Go to Form Settings > Data Retention.
  3. Set a custom retention period for this form.
  4. Save the form.

Form-level policies always take precedence over the organization default.

Minimum Retention Periods

Depending on your compliance requirements, certain minimums apply:

Compliance FrameworkMinimum RetentionData Type
SOC 2365 daysAudit logs
HIPAA6 yearsPHI-related records
GDPRNo minimum (purpose-based)Personal data
General30 daysAll data (soft delete window)

Compliance Minimums

BttrForm enforces minimum retention periods based on your organization's compliance settings. If HIPAA mode is enabled, you cannot set a retention period shorter than 6 years for forms containing PHI.

Audit Log Retention

Audit logs have their own retention rules, separate from form response data.

Default: 365 Days

SOC 2 requires a minimum of 365 days of audit log retention. This is the default for all BttrForm organizations and cannot be reduced below this threshold.

Extended Retention

Organizations on Business and Enterprise plans can extend audit log retention:

PlanMaximum Retention
Free365 days (fixed)
Pro365 days (fixed)
BusinessUp to 3 years
EnterpriseUp to 7 years

To configure extended retention:

  1. Navigate to Settings > Compliance > Audit Log Retention.
  2. Select your desired retention period.
  3. Save. The new retention period applies to all future audit log entries. Existing entries are retained for whichever period is longer -- the old setting or the new setting.

Immutable Logs

Audit logs are immutable once written. They cannot be edited or deleted by any user, including organization owners. This ensures the integrity of your audit trail for compliance purposes.

Automatic Deletion Behavior

When data reaches the end of its retention period, BttrForm processes it through an automated deletion pipeline.

How Automatic Deletion Works

1. Daily cron job runs at 2:00 AM UTC
2. Identifies records past their retention period
3. Records marked for deletion (soft delete)
4. 30-day grace period begins
5. After grace period, data permanently deleted
6. Deletion logged in audit trail
7. Associated files removed from object storage

Important Details

  • Irreversible after grace period -- Once the 30-day grace period expires, data is permanently deleted and cannot be recovered.
  • Cascade deletion -- When a form response is deleted, associated file uploads are also deleted.
  • Batch processing -- Deletion runs in batches to avoid performance impact. Large datasets may take multiple cycles to fully process.
  • Deletion confirmation -- Organization admins receive a weekly summary email listing data deleted by retention policies.

Permanent Deletion

Automatic deletion is irreversible after the 30-day grace period. Ensure you have exported any data you need to keep before the retention period and grace period expire.

Export Before Delete

BttrForm provides multiple ways to export your data before retention policies take effect.

Manual Export

  1. Navigate to Responses for the form you want to export.
  2. Click Export and choose your format (CSV, JSON, or Excel).
  3. Select the date range or specific responses to export.
  4. Download the export file.

Scheduled Exports

Set up automatic exports that run before retention deletion:

  1. Go to Form Settings > Data Retention > Pre-Deletion Export.
  2. Enable automatic export before deletion.
  3. Choose the export format and destination:
    • Email -- Export file sent to specified email addresses.
    • Webhook -- Export data posted to a webhook URL.
    • Cloud storage -- Export pushed to your S3 bucket or Google Cloud Storage (Enterprise plans).
  4. Exports run 7 days before the retention period expires, giving you time to verify the export before data is deleted.

Bulk Export

For large-scale exports across multiple forms:

  1. Navigate to Settings > Data > Export.
  2. Select the forms and date ranges to include.
  3. BttrForm generates the export asynchronously and notifies you when it is ready for download.
  4. Export files are available for 7 days before they are automatically removed.

GDPR Right to Erasure

Under GDPR Article 17, individuals have the right to request deletion of their personal data. BttrForm provides tools to handle these requests.

Handling Deletion Requests

  1. When you receive a deletion request from a respondent, navigate to Settings > Compliance > Data Requests.
  2. Click New Erasure Request.
  3. Enter the respondent's identifying information (email address, name, or submission ID).
  4. BttrForm searches across all forms for matching responses.
  5. Review the matched records and confirm deletion.
  6. Data is permanently deleted (no soft delete period for GDPR erasure requests).
  7. A record of the erasure request is retained in the audit log for compliance documentation.

Data Subject Access Requests (DSAR)

Before deleting data, respondents may request a copy of their data:

  1. Navigate to Settings > Compliance > Data Requests.
  2. Click New Access Request.
  3. Enter the respondent's identifying information.
  4. BttrForm compiles all data associated with that individual across your forms.
  5. Export is generated in a machine-readable format (JSON) and can be sent directly to the requester.

Response Timeline

GDPR requires data access and erasure requests to be fulfilled within 30 days. BttrForm's tools allow you to process most requests within minutes, giving you ample time to review and respond.

Retention Periods by Data Type

The following table summarizes the configurable retention periods for each data type in BttrForm.

Data TypeMinimumDefaultMaximumConfigurable
Form responses30 daysIndefiniteIndefiniteYes
File uploads30 daysIndefiniteIndefiniteYes
Audit logs365 days365 days7 yearsYes (Business/Enterprise)
Analytics (detailed)30 days90 days365 daysYes
Analytics (aggregated)90 days2 yearsIndefiniteNo
Session dataN/A24 hours24 hoursNo
Soft-deleted dataN/A30 days30 daysNo
GDPR erasure records365 days3 years7 yearsYes

Was this helpful?

Data Retention | BttrForm