Deleting a customer removes them from the customer register and breaks related links. Delete customers in the browser. The customer views in the Android and iOS apps do not have a customer deletion function.

When can a customer be deleted?

You need permission to view and delete the customer. Edit permission alone is not enough. The trash icon on the row is displayed based on delete permission, but it does not guarantee that the customer's links allow deletion.

A customer cannot be deleted if they have even one contract or a linked offer. This check covers all statuses: a contract that has ended, been archived or been marked as deleted, and an offer that has been cancelled, archived or marked as deleted, will also prevent deletion if the customer link remains. The error message about contracts refers to active contracts, but the check covers all of the customer's contracts.

If you want to keep the customer's details and links, use the Not in use status instead of deleting them. Open the customer by clicking their name in the customer table. In the Basic info section of the form's Basic info tab, set the Status field to Not in use and click Save at the bottom. This requires edit permission. The customer remains in the register and can be made active again. Changing the status does not delete contracts or offers or bypass anything that prevents deletion. See also changing customer details and status. Do not delete necessary contract or offer history just to make it possible to delete a customer.

Check contract and offer links

Viewing contracts and offers requires the service's Field service management feature and permission to read the relevant information. If you cannot check the links, ask an administrator to investigate them. An empty list or a list restricted by permissions does not, on its own, prove that the customer has no links preventing deletion.

Contracts, including those marked as deleted

Open Customers → Contracts from the main menu and select Datatable. Use the Customer column filter to select the correct customer and remove any other unnecessary filters. Click a contract's name to view its details if the contract can be opened normally. See contract history, archiving and deletion.

Deleting a contract does not always remove its customer link. If the contract has related tasks or contract invoices, it is marked as deleted and retained with its customer link. It disappears from the regular Contracts list but still prevents the customer from being deleted. If there are no tasks or contract invoices, the contract record is deleted.

You can check contracts marked as deleted on the customer's own form. Open Customers → Customers from the main menu and click the customer's card or their name in the table. Open the form's Contracts tab and clear Hide deleted contracts above the table. If necessary, also remove the table's other filters. The list shows the customer's contracts that your permissions allow you to view, including those marked as deleted. However, a contract marked as deleted cannot be opened in the regular contract form.

Offers and deletion restrictions

Open Customers → Offers from the main menu and select the Datatables tab. Find the customer using the table's Customer column filter. Select Show cancelled & archived above the table and remove any other unnecessary filters. This option does not show offers marked as deleted. See offer statuses and deletion.

Deleting an offer is not a general solution to a blocked customer deletion. If the offer has linked tasks, confirming deletion removes the task links but retains the offer marked as deleted, with its customer link intact. The tasks remain. If there are no task links, the offer cannot be deleted when it has a linked customer or contact.

An offer marked as deleted is absent from the offer views and cannot be opened in the regular offer form. If deletion is still blocked after you have checked the visible lists, ask an administrator to investigate links marked as deleted as well. Do not assume that a contract or offer disappearing from a list has made the customer eligible for deletion.

What does deletion change?

Before confirming, check the customer's name, customer number and linked folders. When deletion succeeds:

  • The customer is removed from the customer register.
  • The customer's links to their folders are removed. The folders, their subfolders and Spots remain. Removing this customer link does not clear the folder's separate site customer details.
  • The customer's contact links are removed. The people remain in the contact register.
  • The customer's discounts, product pricing margins and price list links are removed. The price lists and products remain.
  • Work orders remain, but the deleted customer no longer appears in their customer details.

Deletion does not delete tasks, service requests or messages related to the folders' Spots. However, their customer link comes through the folder, so they are no longer associated with the deleted customer. This affects, for example, filtering the task table by customer. In the Dashboard's breakdown of time spent on tasks by customer, time entries no longer belong to the deleted customer, although the user's total time remains.

Deleting a customer is different from setting them to inactive or clearing all related history. A deleted customer cannot be restored by changing their status.

Delete one customer

  1. Open Customers → Customers from the browser's main menu. On the page's Customers tab, select Datatable.
  2. Find the customer using the Name or Customer number column filter and check that you have the correct row.
  3. Click the trash icon on the customer's row. The trash icon in the table header does not delete an individual customer.
  4. Confirm deletion by selecting Yes. Select No to cancel.

After successful deletion, the row disappears from the table and you receive the notification Deleted successfully. If deletion is blocked, the interface displays an error and does not remove the row. Check the customer's contracts and offers as described above, as well as your delete permissions.

Delete multiple customers

  1. In the same customer table, select the checkboxes on the rows of the customers you want to delete.
  2. Open the Actions menu in the checkbox column header and select Delete chosen rows.
  3. Check the number of selected customers in the confirmation and confirm by selecting Yes. No cancels the action.

Bulk deletion runs in the background, so it may take a moment. The notification Deleting process started. Remember to refresh the page to see the changes. confirms that processing has started, not that all selected customers have been deleted.

Only some of the selected customers may be deleted. Only customers you have permission to delete are processed. Customers with contracts are skipped, and deletion of a customer linked to an offer is blocked. Failure to delete one customer does not undo successful deletions of others.

Check the result

Reload the page; for bulk deletion, allow time for background processing first. Clear the customer table's other filters and search for each customer selected for deletion by name or customer number. A row missing from a filtered view does not prove that it has been deleted.

If a customer remains visible, check what is preventing deletion. Bulk deletion does not display a list of results for each customer; attempting to delete an individual customer displays any error. If you are unsure whether processing has finished, ask an administrator to investigate.

Also check the previously linked folders. Open Assets and content → Folder tree → Folder tree from the browser's main menu, click the folder's name and open the form's Customer tab. The Customer of the folder field in its Customer section must no longer contain the deleted customer. The folder and its Spots should still exist. If the folder needs a new customer link, see linking a customer to a folder.

On Android and iOS, open Customers from the side menu and refresh the regular customer list by pulling down. Wait for the fetch to succeed before assessing the result. An unrefreshed list or a customer missing from the first batch loaded does not confirm deletion; verify the result primarily in the browser's customer table. Mobile search and use of the list are described in viewing customer details on mobile.