CPQ Settings (Master Settings) — Admin Guide
Environment-wide CPQ configuration — pricing defaults, product filters, permissions, numbering, contracts handoff, and e-signing setup.
Audience: Good Sign admin users responsible for the environment-wide configuration that applies to all CPQ forms and quotes. Scope: the CPQ Settings dialog — what it controls, what each tab does, and how it relates to per-form overrides in the form activation dialog. Naming note: the dialog is titled CPQ Settings in the live UI. The previous public guide referred to it as Master Settings; both names refer to the same dialog. This guide uses CPQ Settings with Master Settings in parentheses where useful for continuity. See also: CPQ Forms — Admin Guide (for the per-form activation dialog that mirrors several of these tabs), CPQ User Management (for the rights that gate this page).
1. What CPQ Settings is
CPQ Settings is the single page where an admin sets environment-wide defaults for CPQ — pricing organisation, product filters, numbering format, e-signing integration, and the behaviour at quote approval.
Each tab in the dialog sets defaults that apply to all CPQ forms and products in the environment. Some tabs also contain a toggle that determines whether individual forms are allowed to override the system-wide default on their own activation dialog. That toggle-driven override mechanism is the key concept to understand before changing anything here.
CPQ Settings is set once during initial environment setup and revisited only when something at the system level changes — adding a new product category, switching e-signing provider, changing the default pricing organisation, etc. It is not a page admins touch frequently.
2. Who can access this feature
CPQ Settings is gated by Menu - CPQ Admin settings (3275). An admin who has CPQ admin access to forms and templates but not right 3275 will not see the gear icon on the Forms list and will not be able to open this dialog.
If the gear is not visible:
- Check the user’s rights in Good Sign Billing under
Settings → Users → right-click → User Rights. - Use the Right filter to search for
3275orCPQ Admin settings. - If the right is missing, add it directly or via a profile (e.g. CPQ Admin-style bundles in your environment).
See CPQ User Management for the full rights-checking workflow.
User rights and profiles are environment-specific and configured by system administrators — profile names and contents vary between environments.
3. Where it lives
CPQ Settings opens from the Forms list:
Settings → CPQ → Forms → small gear icon in the top-right page controls (next to the search box and the + Create Form button).
A dialog titled CPQ Settings opens. Click Save to persist changes, Cancel to discard.
4. The six tabs
The dialog has six tabs. Each is described below in the order they appear.
4.1 Pricing
Sets the default pricing organisation used for products in CPQ forms. The pricing organisation determines which Billing-side pricing rules apply when a salesperson configures a quote.
| Field | Notes |
|---|---|
| Organization | The default pricing organisation. Pulled from the Billing organisation tree. Tooltip: "Default pricing organization for CPQ products by CPQ Forms." |
| Enable option to set pricing organization by form | When On, the per-form Pricing tab in the form activation dialog becomes available, and an admin can override this default on individual forms. When Off, all forms use the default set here |
| Enable option to set schedule based pricing models by phases | When On, the engine supports schedule-based pricing where pricing models are tied to phases of a contract. |
When schedule-based pricing by phases is enabled, it allows defining different prices and discounts for a product across time periods. For example, a product can have a lower price or discount for an initial period and a different price or discount in later periods.
4.2 Products
Filters which products in the Billing product catalogue are eligible to appear inside CPQ forms.
| Field | Notes |
|---|---|
| Product category | If set, only products under the selected category are available in CPQ forms. Currently supports one category. Tooltip: "If set, only products under the selected product category will be added to quote forms/sections." |
| Product dimension | If set, only products with the selected dimension are available in CPQ — regardless of their category. The product name and description shown in CPQ also follow this dimension. Tooltip: "If set, only products with the selected dimension will be added to quote forms/sections. Also, the product name/description will correspond to the selected dimensions." |
Recommended: use Product dimension rather than Product category when possible. A dedicated CPQ dimension can be created in Billing and assigned to products that should be available in CPQ — this avoids constraining the product catalogue’s overall structure.
Special case: if a CPQ Product dimension is defined here, it is not automatically assigned to newly created products (other dimensions are). This prevents new products from appearing in CPQ until an admin explicitly tags them with the CPQ dimension.
4.3 Permissions
Controls whether per-form user-permission overrides are enabled.
| Field | Notes |
|---|---|
| Enable option to set user permission by form | When On, the per-form Permission tab in the form activation dialog becomes available, and an admin can set a user-rights profile required to access each individual form from the CPQ client |
Form visibility rules. A salesperson sees a CPQ form only when both apply: (1) they have the user right assigned to the form (or one of its parents) for the selected organisation, and (2) the form is in Activated status. Without the user right, the form is invisible to the salesperson even after activation.
4.4 Numbering
Sets the auto-generated quote-number format.
| Field | Notes |
|---|---|
| ID Prefix | The prefix prepended to every quote number. Example default: QU-, producing numbers like QU-0000001 |
| ID Length | The length of the numeric portion of the quote number. Example: 10 |
| Enable option to set numbering formula by form | When On, individual forms could use their own numbering schemes. The database supports per-form numbering, but the per-form UI surface for this is not yet fully exposed. |
Changing the numbering settings affects new quotes only; existing quote numbers are unchanged.
Note: Each quote also has a unique internal key. The numbering settings here define the customer-facing reference number, not the internal key.
4.5 Contracts
Controls whether CPQ auto-creates billing artefacts at quote approval.
| Field | Notes |
|---|---|
| Create new organisations by CPQ | When On, approving a quote for a customer that does not yet exist as a Billing organisation triggers CPQ to create the organisation automatically |
| Root for new organisations | The parent node in the Billing organisation tree under which CPQ-created orgs are placed |
| Create contracts by CPQ | When On, approving a quote creates a contract in Billing automatically, with the products and prices from the approved quote |
| Default status for new contracts | The state new contracts are created in — for example Draft, so the billing team can review and activate before the contract goes live |
These four fields together define the CPQ → Billing handoff at quote approval. They are the single most important set of settings for any environment where CPQ feeds Billing — make sure they match how the billing team expects to receive new contracts.
4.6 E-Signing
Configures the e-signing provider and credentials used when an activated form has its per-form E-Signing toggle on. Supported providers: OneFlow and Visma Sign. The provider dropdown determines which credential fields appear below.
This page is purely admin setup. The actual “send this quote for signature” action happens on the CPQ Client side when a salesperson generates a quote — see the CPQ Client / sales-user guide for that workflow.
| Field | Notes |
|---|---|
| E-signing | Master toggle for e-signing across the environment. When Off, no e-signing is used regardless of per-form settings |
| E-Signing provider | OneFlow or Visma Sign. Selecting the provider swaps the credential fields below to match what that provider requires |
| API Token | The provider's API token. Required. Stored masked |
| Admin User Email | The admin email tied to the provider account (labelled OneFlow Admin User Email when OneFlow is selected; equivalent field for Visma Sign) |
| Workspace ID | The provider workspace identifier (OneFlow) |
| Template ID | The provider-side template identifier used for signing flows |
| API URL | The provider's API base URL (e.g. https://api.oneflow.com/v1 for OneFlow; corresponding endpoint for Visma Sign) |
| Manage Signatories in CPQ | Numeric flag. |
| Integration model | Numeric flag controlling how CPQ integrates with the provider. |
Field set may differ by provider. The fields verified above were captured with OneFlow selected. Visma Sign uses a similar field set, but exact field names (e.g. Workspace ID equivalent) and the API URL value differ. Confirm the field list with Visma Sign documentation before saving.
E-signing settings are environment-specific. Coordinate with the chosen e-signing provider’s account admin to get the correct credentials before turning the master toggle on.
5. How CPQ Settings interacts with form activation
Three of the six tabs (Pricing, Permissions, Numbering) contain a toggle that controls whether per-form overrides are exposed in the form activation dialog (see CPQ Forms — Admin Guide §8):
| CPQ Settings tab | The toggle | Effect when On | Effect when Off |
|---|---|---|---|
| Pricing | Enable option to set pricing organization by form | The Pricing tab on a form's activation dialog accepts a per-form pricing organisation | All forms use the default Organization set in CPQ Settings → Pricing |
| Permissions | Enable option to set user permission by form | The Permission tab on a form's activation dialog accepts a per-form user right | All forms inherit whatever default applies; no per-form override is possible |
| Numbering | Enable option to set numbering formula by form | Per-form numbering schemes become possible | All forms use the default Prefix and Length set in CPQ Settings → Numbering |
The Contracts and E-Signing tabs work differently — Contracts has no per-form override (system-wide only); E-Signing has a master on/off toggle here plus an on/off toggle per form on the form activation dialog (so a form can opt out of e-signing even when the environment supports it).
The Products tab has no per-form override at all — it’s purely a global filter on the product catalogue available to CPQ.
6. Scope and limitations
Verified in the live UI
- The dialog is titled CPQ Settings (previously Master Settings)
- Six tabs: Pricing, Products, Permissions, Numbering, Contracts (new), E-Signing (new)
- The Pricing tab now has a second toggle for schedule-based pricing models by phases (new)
- E-Signing supports OneFlow and Visma Sign as providers
- Right 3275 (Menu - CPQ Admin settings) gates access to the dialog
7. Quick reference
| Task | Path / Click |
|---|---|
| Open CPQ Settings | Settings → CPQ → Forms → gear icon (top right) |
| Change the default pricing organisation | Pricing tab → Organization |
| Allow per-form pricing override | Pricing tab → toggle Enable option to set pricing organization by form to On |
| Filter CPQ products to a category | Products tab → Product category |
| Filter CPQ products by dimension | Products tab → Product dimension |
| Allow per-form permission override | Permissions tab → toggle to On |
| Change quote number format | Numbering tab → ID Prefix and ID Length |
| Auto-create Billing orgs from CPQ quotes | Contracts tab → toggle Create new organisations by CPQ to On + set Root |
| Auto-create Billing contracts from CPQ quotes | Contracts tab → toggle Create contracts by CPQ to On + set Default status |
| Enable e-signing for the environment | E-Signing tab → toggle on + provider + credentials |
| Check who can access CPQ Settings | Settings → Users → right-click user → User Rights, filter on CPQ Admin settings (3275) |