Skip to content

Commit 116455e

Browse files
MichaelBDavisclaude
andcommitted
Handbook: document the HubSpot quote naming convention
Adds a "Quote Naming Convention" section to Engagements & Pricing, under Generating a Quote, defining the standard name for every HubSpot quote: Quote - [Company] - [Order Type] - [Product] - [Year] - v## Each segment is anchored to an existing source of truth: the Company record for the name, the deal's Deal Type for the order type, and the Edge/Hub/Fleet Quote Template for the product. Year is the subscription term start year rather than the quote-authoring year, so the name stays stable when a start date slips within the year, and versions reset per transaction. Also states that the record ID and execution status stay out of the name, since HubSpot tracks both and the Company Quote Reference Number is the identifier customers cite on a purchase order. Cross-referenced from step 1 of Creating a Quote, where the name is actually entered, and from Deal Management in the HubSpot page. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
1 parent d7f5f02 commit 116455e

2 files changed

Lines changed: 35 additions & 1 deletion

File tree

nuxt/content/handbook/sales/engagements.md

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -46,13 +46,47 @@ When preparing a quote, include the product, quantities, and any required add-on
4646

4747
Use the internal pricing calculator linked above to configure each product sale, including the correct quantities and add-ons.
4848

49+
### Quote Naming Convention
50+
51+
Every quote is named the same way, so that quotes are identifiable at a glance
52+
in HubSpot and stay identifiable once the signed copy is filed in Drive
53+
alongside purchase orders and agreements:
54+
55+
`Quote - [Company] - [Order Type] - [Product] - [Year] - v##`
56+
57+
For example: `Quote - Acme Corp - Renewal - Hub - 2026 - v01`
58+
59+
- **Company** - the company name exactly as it appears on the HubSpot Company
60+
record. This is internal identification only; the contracting legal entity is
61+
set in the Buyer Information section of the quote itself.
62+
- **Order Type** - `New Business`, `Expansion`, or `Renewal`, matching the
63+
deal's [Deal Type](#creating-a-deal). Use `Amendment` for a change to an
64+
already-executed contract; it is a document type only and has no
65+
corresponding Deal Type.
66+
- **Product** - `Edge`, `Hub`, or `Fleet`, matching the Quote Template selected
67+
in [Creating a Quote](#creating-a-quote). For more than one product, join them
68+
with a slash (`Edge/Hub`, `Edge/Fleet`). Use `Services` for a Professional
69+
Services-only quote.
70+
- **Year** - the year the subscription term starts, not the year the quote is
71+
written. A renewal quoted in December 2026 for a term starting January 2027 is
72+
`2027`.
73+
- **v##** - the version, starting at `v01`. Increment it for each quote created
74+
for the same transaction. Never reuse a number, including for a quote that was
75+
voided.
76+
77+
Do not put the HubSpot record ID or the execution status in the name. HubSpot
78+
tracks both, and the Company Quote Reference Number printed on the quote is the
79+
identifier customers cite on a purchase order (see
80+
[Closing a deal](#closing-a-deal)).
81+
4982
### Creating a Quote
5083

5184
Follow these steps to create a quote.
5285

5386
1. In HubSpot, open the relevant Deal. In the Quotes area, click Add to begin a
5487
new quote.
5588
- Ensure the Deal Type is set up, "Expension" is an in-term upsel
89+
- Name the quote per the [Quote Naming Convention](#quote-naming-convention)
5690
2. Fill in the Buyer Information section. This will pre-fill with the
5791
information from the contact in the Deal.
5892
3. The default Quote creator will be you. Change this if necessary.

nuxt/content/handbook/sales/hubspot.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -72,7 +72,7 @@ through other marketing activities too, but wasn't nurtured to the point of a me
7272

7373
## Deal Management
7474

75-
A HubSpot deal represents a specific revenue opportunity with a customer or prospect: an active buying process with an engaged buyer, a realistic close date, and next steps the deal owner can work. We open a deal for each type of revenue opportunity: new business, expansion (in-term or at renewal), pilot-contingent expansion, and renewal. The rules for each type are below. Once a deal is open, quoting and closing it follows [Engagements & Pricing](/handbook/sales/engagements/#creating-a-deal).
75+
A HubSpot deal represents a specific revenue opportunity with a customer or prospect: an active buying process with an engaged buyer, a realistic close date, and next steps the deal owner can work. We open a deal for each type of revenue opportunity: new business, expansion (in-term or at renewal), pilot-contingent expansion, and renewal. The rules for each type are below. Once a deal is open, quoting and closing it follows [Engagements & Pricing](/handbook/sales/engagements/#creating-a-deal), including the [quote naming convention](/handbook/sales/engagements/#quote-naming-convention).
7676

7777
### Deal Amount Fields
7878

0 commit comments

Comments
 (0)