Scenario
A user attempts to delete a custom record, but the delete action is unavailable or NetSuite prevents the deletion.
Common symptoms include:
- The Delete button is missing.
- Users receive an error when attempting deletion.
- Administrators can delete the record, but standard users cannot.
- The record appears linked to other records or transactions.
This is a common issue in SuiteBuilder environments where permissions, dependencies, workflows, or system relationships prevent record deletion.
Solution
Review the custom record configuration and related dependencies preventing the deletion.
Common causes include:
- Permission Restrictions
- Users must have sufficient permission to:
- The custom record type
- Related records
- Verify the role includes appropriate delete access.
- Record Is Referenced by Other Records
- NetSuite may prevent deletion if the record is linked to:
- Transactions
- Parent records
- Child records
- Saved searches
- Workflows
- Scripts
- Review related records and dependencies carefully.
- Parent-Child Relationships
- Child custom records linked to parent records may block deletion until dependencies are removed.
- Workflow Restrictions
- Workflows may:
- Lock records
- Prevent deletion
- Hide the delete button
- Review active workflows affecting the record type.
- SuiteScript Restrictions
- User Event Scripts or Client Scripts may block deletion intentionally.
- Review deployed scripts affecting the custom record.
- Inactive vs Delete Behavior
- Some organizations use inactive records instead of deleting records entirely.
- Certain records may be intentionally protected from deletion for audit or reporting purposes.
- System or Bundle Dependencies
- Records created through bundles or SuiteApps may have restrictions preventing direct deletion.
- Approval or Status Restrictions
- Approved or processed records may become locked against deletion automatically.
Notes
In many NetSuite environments, deletion restrictions are intentional to preserve reporting integrity, transaction history, and workflow relationships.
When troubleshooting:
- Test using the Administrator role.
- Review related records and dependencies.
- Check Workflow History and Script Deployments.
- Verify whether the delete button is hidden or the delete action itself is blocked.
- Test on a standard form where possible.
Testing deletion behavior in a sandbox environment is strongly recommended before modifying workflows, scripts, or permissions in Production.