Deleting custom object records

You can manually delete one or more custom object records from a custom object. You can delete up to 50,000 records at a time.

Tip: You can automate the deletion of custom object records using the Delete Custom Object Record action step available on the program canvas for custom object programs. You can push changed records to a program and evaluate the record before deleting it. Use decision steps like Compare Custom Object Fields, Has Linked Contact, or Compare Date to evaluate the record. If the record needs to be deleted, then use the Delete Custom Object Record action step. Learn more about custom object programs.

To delete a custom object record manually:

  1. Navigate to Audience An image of the Audience icon., then click Custom Objects.
  2. Open the custom object.
  3. Choose an option:
    OptionSteps
    To delete an individual custom object record
    1. Click View Custom Object Record.

      An image of the View Custom Object Record option.

    2. Click the drop-down next to the record and then click Delete Custom Object Record.
    To delete multiple records
    1. Click Reporting, then click Custom Object Records Data.

      An image highlighting the Custom Object Records Data menu option

    2. Select all the records that you want to delete.

      An image selecting the Custom Object Records to be deleted

    3. Click Actions and then click Delete Custom Object Records.
    To delete all the custom object records
    1. Click View Custom Object Record.

      An image of the View Custom Object Record option.

    2. Click the Custom Data drop-down, then click Delete All Custom Object Records.

    3. Chose an option:

       

    • To delete all records, choose All Records.
    • To delete all records based on the created date of the record, choose Select Condition and set a date or range that will cover the date created the records you want to delete.

    • Clicking Estimate Deletion Count will return the number of records that currently meet the criteria for deletion, including read only records. This is an estimation, any changes to records or records created after the estimation has been triggered may still be deleted.

    • To delete all custom object records that meet the selected condition in this custom object and that are not read-only, click Delete.

    • To delete all custom object records that meet the selected condition including read-only records, click Override and Delete.

    To delete all custom object records not mapped to any contact or account
    1. Click View Custom Object Record.

      An image of the View Custom Object Record option.

    2. Click the Custom Data drop-down, then click Delete All Unmapped Custom Object Records.

    3. Chose an option:

       

    • To delete all unmapped records select, choose All Records.
    • To delete all records based on the created date of the record, choose Select Condition and set a date or range that will cover the date created the records you want to delete.

    • Clicking Estimate Deletion Count will return the number of records that currently meet the criteria for deletion, including read only records. This is an estimation, any changes to records or records created after the estimation has been triggered may still be deleted.

    • To delete all custom object records not mapped to any contact or account that meet the selected condition in this custom object and that are not read-only, click Delete.

    • To delete all custom object records not mapped to any contact or account that meet the selected condition including read-only records, click Override and Delete.

    To delete linked custom object records upon contact deletion

    Custom objects can be configured to delete a custom object record when the linked contact record is deleted.

    To delete a custom object record when the linked contact is deleted:

    1. Navigate to Audience An image of the Audience icon. > Custom Objects.

    2. Open the custom object that require records to be deleted when the linked contacts are deleted.

    3. Under the heading Custom Object Record Deletion check the box Deleted Linked Custom Object Records upon Contact Deletion.

      Custom Object Screen with Delete Linked Record Upon Contact Deletion checkbox

    4. Save the custom object

    Going forward any time a contact is deleted linked custom object records in the custom object where the checkbox is enabled will also be deleted. The setting is per custom object, so only records custom objects where the checkbox is enabled will delete the linked records on contact deletion. Custom object records that were linked to a deleted contact prior to enabling the feature will not be deleted.

Learn more

Managing custom object record services

Viewing custom object record reports

Custom objects