Learn why SuiteCommerce may prevent website setup record deletion and follow detailed steps to resolve dependency issues and free up your domain license.
When working in SuiteCommerce, you may need to remove a website setup record, especially when reallocating a limited domain license. However, Admins often find that deleting this record is not straightforward. Instead, NetSuite may display an error message indicating that dependencies are preventing its removal.
At Versich, we’ve helped clients resolve these types of SuiteCommerce errors. In this article, we’ll explain the issue, outline the underlying causes, and provide a reliable step-by-step solution for resolving the error.
Understanding the Website Setup Deletion Issue in SuiteCommerce
SuiteCommerce Admins attempting to delete a website setup record may find that NetSuite rejects the request. The common error message states that the record “cannot be deleted because it has dependent records,” even when no directly linked records appear.
This issue often occurs when clients have a single domain license and need to reassign it. Deleting the website setup record is necessary to release the license. Although the goal is straightforward, hidden dependencies can prevent the process from being completed.
What Triggers the Deletion Error?
Our team at Versich encountered this situation when a client needed to delete a domain record but had only one SuiteCommerce license provisioned. To reuse the license, we needed to delete the associated website setup record.
Here's how the problem manifested:
1. Navigation Path: Go to Commerce > Websites > Website List, then open the desired Website Setup Record.
2. Attempted Action: From within the record or the “Actions” dropdown, select Delete.
3. System Response: NetSuite displayed the following message: *“This record cannot be deleted because it has dependent records.”*
Sometimes, selecting the link to view dependent records displays an empty list, which can make troubleshooting more difficult.
Initial Diagnostics: Investigating Dependencies
Even when the dependent records list appears empty, the Website Setup Record may still reference several underlying components. These typically include:
The Configuration Record
Active Extensions
The Extension Activation Record
The attached Domain Record
Resolving the deletion error requires a methodical approach to manually remove these supporting records.
Step 1: Deleting the Configuration Record
There is no quick way to remove the Configuration Record, so it must be handled carefully to preserve the settings for future reference.
Follow these steps:
Step 1: Go to Customizations > Lists, Fields, Records > Record Types.
Step 2: Search for SC Configuration and choose List.
Step 3: Find the Configuration ID related to the site in question and click Edit.
Step 4: *Important*: Save a copy of the Configuration JSON, such as in OneNote or VSCode, before proceeding.
Step 5: From the actions dropdown, select Delete.
Once completed, the Configuration Record will be removed.
Step 2: Remove Extension Activations from the System
To fully remove the Website Setup Record, you must first delete any associated extension activations. Follow these instructions carefully:
1. Access the SC ExtMech Activation Record. Go to: *Customizations > Lists, Fields, Records > Record Types*. In the list of record types, locate SC ExtMech Activation using the search or scroll function.
2. View the List of Activations. Click on the list connected to the SC ExtMech Activation record.
3. Find and Edit the Relevant Activation ID. Identify the activation that corresponds to the store you are attempting to delete. Click the Activation ID to view its details.
4. Delete the Activation Record. From the Actions dropdown menu, choose Delete. This action will remove the activation from the system.
Final Step: Remove the Domain Record
The last step before you can successfully delete the Website Setup Record is to remove the related domain record. This is typically the easiest part of the process.
1. Navigate to Domain Management. Go to: *Commerce > Hosting > Domains*.
2. Select the Domain for Deletion. Find the domain you want to remove and enter Edit mode for that record.
3. Use the Action Dropdown to Delete. From the Actions menu, select Delete. This will remove the domain association.
Once you’ve deleted these four elements, site category records, web hosting files, extension activations, and the domain, you should be able to delete the Website Setup Record without encountering the error.
Additional Resources and Troubleshooting Tips
SuiteCommerce Website Setup Record Showing Warning About Addresses Not Digitally Signed
Activating the Extension Manager | SuiteCommerce
If you encounter challenges with these steps, let us know. The team at Versich updates its support documentation as new developments arise, especially when a missed configuration or new NetSuite requirement surfaces. Your feedback helps ensure these resources remain accurate and useful for the SuiteCommerce community.
Connect with a Certified NetSuite Partner
Need hands-on assistance? Versich is proud to be a certified Oracle NetSuite Alliance Partner and Commerce Partner. Our developers and consultants specialize in SuiteCommerce implementations, extensions, and backend customization. Whether you’re launching a new online storefront or resolving complex system errors, our team has handled it before and solved it.
As a premier SuiteCommerce agency, we also build advanced customer portals that help manufacturers, distributors, and retailers streamline their workflows. Unlike most firms, Versich doesn’t just promise solutions, we deliver ones we’ve already tested and proven.
Ready to discuss your SuiteCommerce needs? Reach out to Versich today.
