Skip to main content
Quotes

List and unlist quote templates and widgets

Retire a template or widget from new use without deleting it. Unlisted items stay on existing quotes and templates, and you can list them again later.

Written By Bram Fofana

Last updated 10 days ago

Templates and widgets can only leave everyday use by deletion β€” and deletion has no undo. List and Unlist give the library the same retire-without-delete path that products already have.

Unlisted means unavailable for direct new use. Existing quotes and templates that already use the item keep working.

Where to find it

  • Quotes β†’ Templates β€” list or unlist a quote template from the row actions.
  • Quotes β†’ Widgets β€” list or unlist a widget from the row actions.

Both overviews have a Visibility filter: Listed, Unlisted, or All. The page defaults to Listed.

Marketplace administration is unchanged. A copy you import from the marketplace starts listed.

What unlisted means

SituationWhat happens
New quote, Apply template, widget pickersThe unlisted item does not appear
Company default pickerOnly listed templates appear. Assigning a company default through the company form uses that picker.
Public API list endpointsOnly listed items are returned
Public API get-by-idThe unlisted item still loads so existing integrations can keep reading it
Existing quotes and existing template linksThe item still loads and still receives edits
Copy a template or widgetThe copy starts listed
Licensing-renewal import that points at an unlisted itemThe import is rejected

Creating a quote from a company default still works if that default template is listed. You cannot unlist a default until you replace it (see below).

Unlist or list a template

  1. Open Quotes β†’ Templates.
  2. Use Visibility if you need to find an unlisted template.
  3. On the row, choose Unlist template or List template.

A template that is the tenant default for new quotes, the self-service default, or a company default cannot be unlisted until you assign a different default. The error names what to replace, for example:

Cannot unlist this template until you replace the tenant default for new quotes.

If more than one default still points at the template, the message lists each one.

Unlist or list a widget

  1. Open Quotes β†’ Widgets.
  2. On the row, choose Unlist widget or List widget.

If the widget is still linked to templates, Salesbuildr names those templates and asks you to confirm. Existing templates keep the link β€” they continue to render the widget and receive its edits. New quotes created from those templates still receive the linked widget.

Unlisting only hides the widget from pickers so nobody adds it as a new block.

Existing quotes and templates

Unlisting does not detach anything that already references the item:

  • Open quotes still show the template and its widgets.
  • Opening a template that already links an unlisted widget keeps that link. Autosave does not drop it.
  • A sales rep can still apply styling or content edits on the live quote or template.

To put the item back in pickers, list it again from the same overview.

Public API

Quote template and widget template responses include a listed field (true when the field is missing on older records).

  • List returns listed items only.
  • Get by id still returns an unlisted item so existing integrations can keep reading it.
  • Create defaults listed to true when you omit the field.
  • Update leaves visibility unchanged when you omit listed.
  • Creating a quote from an unlisted templateId is rejected.

See Public API for the resource list.

See also