---
schema_version: "1"
id: 4670eb5fc6f694ec345789d5a5840a6564dbea6813c89dbd0b13b87d84fecf6d
title: Considerations for Truncating Custom Objects
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/platform/264-0-0/dev_object_trunc_overview.md
canonical_url: https://help.salesforce.com/s/articleView?id=platform.dev_object_trunc_overview.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 8f1c6c473e03dbfea9f85557560960f6d705e2831a3164fbf59d496efab3678b
description: It’s important to understand what truncating an object does before you use it to remove records.
products:
  - Salesforce Platform
  - Security
release: "264"
---
# Considerations for Truncating Custom Objects

It’s important to understand what truncating an object does before you use it to remove records.

### Required Editions

![Important](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-extend_click-264-0-0-production-enus/5f7d9219-b7b1-4552-8891-f1aba9b289fc/images/icon_important.png)

Important Where possible, we changed noninclusive terms to align with our company value of Equality. We maintained certain terms to avoid any effect on customer implementations.

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small edition"><colgroup><col></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: both Salesforce Classic and Lightning Experience</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: <strong>Contact Manager</strong>, <strong>Group</strong>, <strong>Professional</strong>, <strong>Enterprise</strong>, <strong>Performance</strong>, <strong>Unlimited</strong>, <strong>Developer</strong>, and <strong>Database.com</strong> Editions</td></tr></tbody></table>

Truncating a custom object lets you remove all of the object’s records, while keeping the object and its metadata. Truncating custom objects is similar to the mass delete option available for standard objects.

Truncating a custom object permanently removes all of its records. You can’t recover the records from the Recycle Bin. A copy of the truncated object appears in the Deleted Objects list for 15 days—during this period the object and its records continue to count toward your org’s limits—and then the copied object and its records are permanently deleted.

In contrast, if you delete a custom object, the object moves to the Deleted Objects list for 15 days. After that the object and its records are permanently deleted.

![Important](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-extend_click-264-0-0-production-enus/5f7d9219-b7b1-4552-8891-f1aba9b289fc/images/icon_important.png)

Important Truncated custom objects can’t be restored to their original state.

You can’t truncate standard objects or custom objects that:

- Are referenced by another object through a lookup field or that are on the master side of a master-detail relationship
- Are referenced in a reporting snapshot
- Have a custom index or an external ID
- Have activated skinny tables

In addition, you can’t truncate custom objects when your org has reached its limit on allowed custom objects.

Truncating a custom object erases:

- All records currently sitting in the custom object’s Recycle Bin
- The custom object’s history
- Related events, tasks, notes, and attachments for each deleted record

Truncating a custom object breaks:

- Bookmarks to the truncated object and its records. If someone clicks a bookmark to the truncated custom object or to a deleted record’s URL, Salesforce displays an Insufficient Privileges message.
- Apex scripts and Visualforce pages with references to a truncated object or record.

After truncating a custom object, you can continue to use the custom object and add new records. Salesforce preserves:

- The custom object definition and all related definitions
- Workflow rules, actions, and triggers
- Sharing rules associated with the custom object
- Validation rules and approval processes
- Master-detail relationships and formula fields
- Translations
- Mobile configuration settings

When working with truncated objects, keep in mind:

- The truncated object tab has a new URL, so new bookmarks need to be created.
- List views and reports must be refreshed after truncation.
- Roll-up summary fields must be recalculated after truncation.
- There’s no support for truncation in the API.
- To truncate objects that contain master-detail relationships, first truncate the detail (child) objects and then the (master) parent objects, working your way up the relationship tree.

#### See Also

- [Truncate Custom Objects](https://help.salesforce.com/s/articleView?id=platform.dev_object_trunc.htm&release=264.0.0&type=5 "Truncating custom objects allows you to delete all of the object’s records permanently, but preserve the empty object and its metadata.")
- [Manage Deleted Custom Objects](https://help.salesforce.com/s/articleView?id=platform.dev_managing_deleted_custom_objects.htm&release=264.0.0&type=5 "Deleted custom objects appear in the Deleted Objects list for 15 days. During this time, you can choose to permanently delete the object and its data, or you can undelete them. If you undelete a custom object, some manual cleanup can be required to restore list views and other customizations that use the object.")