Deletion Policies
Configure data deletion policies for your server and maintain GDPR compliance.
Policy overview
Clocky offers flexible deletion policies to balance user privacy rights with organizational needs.
Three deletion modes
- Name
Immediate- Description
User data is deleted instantly when requested. Best for privacy-first organizations.
- Name
Grace period- Description
Deletion is delayed for a configurable period. Allows recovery from accidental deletions.
- Name
Requires approval- Description
Admins must manually approve all deletion requests. Maximum control and oversight.
View current policy
/admin-configure-deletion view-config
Shows:
- Current deletion policy
- Grace period duration (if applicable)
- Legal retention status
- Pending deletion requests count
Immediate deletion
Data is deleted permanently and instantly when users request it.
Enable immediate deletion
/admin-configure-deletion set-policy policy:immediate
How it works
- User runs
/data-delete current-serveror/data-delete all-servers - User confirms the deletion
- Data is deleted immediately - no delay, no recovery
- User receives confirmation
- Admins are notified in audit log
What gets deleted
When a user deletes their data:
- All work sessions in the server
- All break records
- User profile data
- Statistics and aggregated data
- Leaderboard entries
- Historical records
Benefits
Pros:
- ✅ Fastest GDPR compliance
- ✅ User has complete control
- ✅ Simplest to manage
- ✅ No admin overhead
- ✅ No data retention liability
Cons:
- ❌ No recovery if accidental
- ❌ Permanent data loss
- ❌ No backup opportunity
Best for
- Privacy-first organizations
- Small teams with low data value
- Servers prioritizing GDPR compliance
- Low-risk data environments
- Users who frequently join/leave
GDPR compliance
Immediate deletion ensures compliance with:
- Article 17: Right to erasure ("right to be forgotten")
- Article 12(3): Erasure without undue delay
- Requirement: Requests fulfilled within 30 days (immediate = instant)
GDPR best practice: Immediate deletion is the safest policy for GDPR compliance. It eliminates any risk of delayed processing or forgotten requests.
Grace period deletion
Deletion is delayed for a specified period, allowing recovery if needed.
Enable grace period
# Set policy to grace period mode
/admin-configure-deletion set-policy policy:grace_period
# Configure the grace period duration
/admin-configure-deletion set-grace-period days:30
- Name
days- Type
- number
- Description
Grace period duration (1-365 days). Common values: 7, 14, 30, 90.
How it works
- User runs
/data-delete current-server - User confirms deletion
- Deletion is scheduled for X days in the future
- Data remains accessible during grace period
- User can cancel deletion anytime before deadline
- After grace period expires, data is permanently deleted
- User is notified 24 hours before deletion
Canceling pending deletion
During the grace period, users can cancel:
# User cancels their own pending deletion
/data-cancel-deletion
Only the user who requested deletion can cancel it.
Benefits
Pros:
- ✅ Recovery window for accidental deletions
- ✅ Time for admins to export data if needed
- ✅ User can change mind
- ✅ Safer than immediate deletion
Cons:
- ❌ Data still stored during grace period
- ❌ Requires tracking pending deletions
- ❌ Slightly slower GDPR compliance
- ❌ More complex to manage
Best for
- Medium-sized teams
- Valuable historical data
- Organizations with data export needs
- Reducing accidental deletion risks
- Compliance with backup policies
Recommended grace periods
| Duration | Use Case | Risk Level |
|---|---|---|
| 7 days | Quick recovery, low-value data | Low |
| 14 days | Standard business cycle | Medium |
| 30 days | Monthly reporting cycles | Medium |
| 90 days | Quarterly audits, high-value data | High |
GDPR compliance: Grace periods are acceptable under GDPR as long as the deletion occurs within 30 days (Article 17). Grace periods longer than 30 days may require justification.
Requires approval
Admins must manually approve all deletion requests before they're processed.
Enable approval mode
/admin-configure-deletion set-policy policy:requires_approval
How it works
- User runs
/data-delete current-server - User confirms deletion request
- Request is submitted to admins - data is NOT deleted yet
- Admins are notified
- Admin reviews request:
/admin-review-deletion-requests list - Admin approves or denies:
/admin-review-deletion-requests review request-id:123 - If approved, data is deleted immediately
- If denied, user is notified with reason
Managing deletion requests
List all pending requests
/admin-review-deletion-requests list
Shows:
- User name
- Request date
- Data scope (current-server vs all-servers)
- Request ID
- Days pending
Review specific request
/admin-review-deletion-requests review request-id:123
Shows detailed view with:
- User information
- Data to be deleted (session count, total hours)
- Request timestamp
- Approve or Deny buttons
Approval workflow
When reviewing a request:
- Verify user identity: Is this the actual user?
- Check reason (if provided): Is it legitimate?
- Export data if needed: Run
/stats user:@username range:all-time - Make decision:
- Approve: Data deleted immediately
- Deny: User notified, no data deleted
Approval reasons:
- ✅ Valid GDPR request
- ✅ User leaving organization
- ✅ User requested voluntarily
- ✅ No legal retention requirements
Denial reasons:
- ❌ User is subject to legal retention
- ❌ Under active audit/investigation
- ❌ Contractual obligation to retain data
- ❌ Request appears fraudulent
Benefits
Pros:
- ✅ Maximum admin control
- ✅ Prevent accidental/malicious deletions
- ✅ Time to export critical data
- ✅ Verify user identity
- ✅ Enforce retention policies
Cons:
- ❌ Requires active admin management
- ❌ Can delay legitimate requests
- ❌ Higher admin workload
- ❌ Potential GDPR compliance issues if slow
Best for
- Large organizations
- Highly regulated industries
- Sensitive or valuable data
- Compliance/audit requirements
- Organizations with retention policies
GDPR considerations
GDPR warning: Approval mode can conflict with GDPR's requirement for "without undue delay" (Article 17). You MUST process requests within 30 days and can only refuse if you have a valid legal ground for retention.
Valid grounds for refusal:
- Compliance with legal obligations (e.g., tax records)
- Defense of legal claims
- Processing is necessary for archiving in public interest
Invalid grounds:
- "We might need it later"
- "It's useful to have"
- Administrative convenience
Best practices for approval mode
- Process requests weekly - don't let them pile up
- Respond within 7 days - keep well under 30-day GDPR limit
- Document denials - keep records of why and legal basis
- Inform users - explain denial reasons clearly
- Automate if possible - approve routine requests quickly
Legal retention
Prevent data deletion for a specified period due to legal requirements.
Enable legal retention
/admin-configure-deletion enable-legal-retention enabled:true
/admin-configure-deletion set-retention-years years:7
- Name
enabled- Type
- boolean
- Description
Enable or disable legal retention
- Name
years- Type
- number
- Description
Retention period (1-99 years)
How it works
When legal retention is enabled:
- User requests data deletion
- System checks if data falls within retention period
- If within retention period → Deletion is denied
- User receives message explaining retention requirement
- After retention period expires → Deletion is allowed
Legal retention requirements
Legal retention is typically required for:
| Industry | Typical Retention | Legal Basis |
|---|---|---|
| Employment records | 7 years | Labor law, tax law |
| Financial records | 7 years | Tax regulations |
| Healthcare | 10 years | HIPAA, medical records law |
| Government contractors | Varies | Contract requirements |
| Legal proceedings | Until resolution | Litigation hold |
Combining with deletion policies
Legal retention works with all deletion modes:
- Immediate + Legal retention: Requests denied if within retention period, instant deletion after
- Grace period + Legal retention: Grace period applies only to data outside retention period
- Approval + Legal retention: Admins can't approve deletions within retention period
GDPR compliance
GDPR and legal retention: GDPR Article 17(3) allows retention when:
- Required by law (employment law, tax law, etc.)
- Necessary for legal claims
- Public interest/archiving purposes
You MUST have a valid legal basis and document it. "Just in case" is NOT a valid reason.
Documenting retention
When enabling legal retention, document:
- Legal basis: Which law requires retention?
- Retention period: How long? (must be reasonable)
- Data categories: What data is retained?
- Review schedule: When will you review this policy?
Example documentation:
Legal Retention Policy - Acme Corp Discord Server
- Basis: Employment Records Law (Local Code §123.45)
- Period: 7 years from end of employment
- Data: All work session records, hours worked, attendance
- Applies to: Current and former employees
- Review: Annually on January 1st
- Effective: January 1, 2024
Decision matrix
Choose the right deletion policy for your needs:
| Factor | Immediate | Grace Period | Approval Required |
|---|---|---|---|
| GDPR compliance | Excellent | Good | Risky |
| Admin workload | None | Low | High |
| Recovery possible | No | Yes (during grace) | Yes (before approval) |
| Data security | Highest | High | Medium |
| User control | Complete | High | Limited |
| Recommended for | Privacy-first | General use | High-value data |
Quick decision guide
Choose Immediate if:
- Privacy is top priority
- Low admin availability
- Low-value data
- Frequent user turnover
Choose Grace Period if:
- Need recovery window
- Moderate-value data
- Want balance of control and privacy
- Monthly reporting cycles
Choose Approval if:
- High-value data
- Regulatory requirements
- Need verification step
- Have dedicated admin resources
Best practices
General recommendations
- Start with grace period: 30 days is a good balance
- Document your policy: Write it down and share with users
- Review quarterly: Is your policy still appropriate?
- Be consistent: Apply rules fairly to all users
- Train admins: Ensure they understand GDPR obligations
Communication
Inform users about:
- Which deletion policy is active
- How long deletions take
- How to cancel (if grace period)
- Legal retention requirements (if any)
- How to contact admins with questions
Compliance
- Keep audit logs: Track all deletion requests and approvals
- Document legal basis: For any retention requirements
- Process promptly: Don't delay beyond GDPR limits
- Train staff: On GDPR rights and obligations
- Review regularly: Update policies as laws change
Troubleshooting
User can't delete data
Error: "Legal retention active"
Cause: Data falls within legal retention period
Solution: Explain retention requirement to user, provide expected deletion date
Deletion requests piling up
Cause: Approval mode enabled, admins not reviewing
Solution:
- Review pending requests:
/admin-review-deletion-requests list - Process each request promptly
- Consider switching to grace period mode if overwhelmed
Grace period too short/long
Problem: Users complaining about grace period duration
Solution:
- Review user feedback
- Adjust grace period:
/admin-configure-deletion set-grace-period days:X - Announce change to users