Skip to content
D
Documentation

Regret reasons

reference
6 min readUpdated

Regret reasons at a glance

Regret reasons are Sales configuration data used to describe why an offer reaches the Regretted to Offer sales outcome. The shared reference screen is titled Regret Reasons.

If you need to…Go to
Find the list and open its new-entry formFind the regret reasons list
Identify the field and stored values used by the formUnderstand the list and form
Choose the right maintenance pathAdd or maintain a regret reason
Add a new reasonAdd a new reason
Change an existing reasonChange an existing reason
Close a form without submitting itLeave a form without saving
Review related Sales reference listsWhat to do next
Return to the surrounding sales workflowMissed, regretted, and cancelled jobs
Read the broader stage flowSales jobs lifecycle

Before you start

Sign in before opening the Sales configuration list. The available actions depend on your subscription, permissions, and saved list layout.

Check before you beginWhat it changes
The Sales subscription includes this featureNew is available only when the subscription is included and the new-button condition allows it.
Editing is allowed for your accountThe row edit action is available only when editing is allowed.
The selected item and a visible form column are availableThe edit form requires a selected item and a column that is visible in the form.
The visible tabsUse the tabs shown on the screen to choose an available reference list.

Use the visible page and tabs to choose what your account can open.

Find the regret reasons list

Prerequisites

  • You are signed in.
  • Your account can open the Sales configuration area.

Steps

  1. Open Configuration.
  2. Open Sales.
  3. Select Regret Reasons.
  4. Confirm that the list shows the Name column.
  5. Confirm that New, Refresh, and Settings are visible.
  6. Select New.

The new-entry form is titled New Regret Reason.

The list with New, Refresh, Settings, and the Name column
The form titled New Regret Reason

Result: The New Regret Reason form is open over the regret-reason list.

Understand the list and form

The list identifies regret reasons through the Name column. The form uses the same Name value as a required text box, while the other stored fields remain hidden from editing.

The columns shown depend on your saved list layout. Name is a visible list column. The form field appears only when the form is open, an item is selected, and the column is visible in the form.

Form or list valueWhat you see
NameA required text box in the edit form and a list column.
DisplayOrderHidden and not editable.
ReasonIDHidden and not editable.
CompanyIDHidden and not editable.
StatusIDHidden and not editable.
ReasonTypeIDHidden and not editable.

The open form shows the required Name field and OK. While the form is open, the list retained New, Refresh, and Settings.

The required Name field in the open form
The open form with the OK control

Add or maintain a regret reason

Choose a maintenance path from the list.

If you need to…Use this path
Start a new reasonSelect New, then follow Add a new reason.
Change an existing reasonUse the icon-only edit action on the reason row when editing is allowed, then follow Change an existing reason.
Leave without submittingSelect Cancel, then follow Leave a form without saving.
Export the listUse Export when the shared display and subscription conditions allow it.

Add a new reason

Use this procedure to open the new-reason form and complete its required field.

Prerequisites

  • The regret-reason list is open.
  • New is visible.
  • The Sales subscription includes this feature and the new-button condition allows the action.

Steps

  1. Select New.
  2. Confirm that the form title is New Regret Reason.
  3. Enter the reason in the required Name text box.
  4. Confirm that OK is visible.
The OK control beneath the required Name field

Result: The New Regret Reason form remains available with a completed required Name field and OK visible.

Change an existing reason

Use the icon-only edit control to change the Name of an existing regret reason when editing is allowed.

Prerequisites

  • The regret-reason list is open.
  • Editing is allowed for your account.
  • The selected item and a visible form column are available.

Steps

  1. Select the icon-only edit action on the reason row.
  2. Change the value in Name.
  3. Confirm the changed value in Name.

Result: The edit form contains the changed Name value.

Leave a form without saving

Select Cancel to close the open form without submitting its data.

Prerequisites

  • The regret-reason form is open.
  • The form's OK control is visible.

Steps

  1. Select Cancel.
  2. Confirm that the form's OK control is absent. Result: The form is closed without a visible dialog, and its OK control is no longer visible.

Delete a reason

Handle access and setup variations

The shared configuration screen can show different actions and fields for different subscriptions, permissions, and saved column layouts. It serves multiple reference entities, so the visible entity list and tabs belong to the shared screen.

VariationWhat changes
Subscription inclusion and the new-button conditionNew is available when both conditions allow it.
Editing permissionThe row edit action is available when editing is allowed.
Form state and column visibilityA form field appears when the form is open, an item is selected, and the field is visible in the form.
List layoutThe columns shown depend on your saved list layout.
Shared screenVisible tabs can navigate to sibling reference lists.

If a field or action is absent, check the subscription, editing permission, and saved column layout before treating the data as missing.

When maintenance does not work

The form responds to forbidden characters with a validation message. A loading indicator can remain visible while the list is loading.

What you seeWhat to do
Forbidden characters detected. Please remove them and try again.Remove the forbidden characters from Name, then try the form action again.
A loading indicator remains visibleRefresh the page and check the list again.

Work from the headers visible in the list because its columns come from the current column configuration.

What to do next

The screen's visible tabs can take you to sibling reference lists.

Continue with…Open
Lost-reason reference dataLost reasons
Cancellation-reason reference dataCancellation reasons
Order-cancellation reference dataOrder-cancellation reasons
Missed, regretted, and cancelled sales jobsMissed, regretted, and cancelled jobs
The complete sales lifecycleSales jobs lifecycle

Result: The visible tabs provide a route to related Sales configuration and workflow pages. The form is not submitted.

Was this page helpful?

Need help using the product?