Skip to content

Commit 96448be

Browse files
Handbook: document the HubSpot quote naming convention (#5729)
Co-authored-by: Claude Opus 5 <noreply@anthropic.com>
1 parent c583eff commit 96448be

2 files changed

Lines changed: 36 additions & 1 deletion

File tree

nuxt/content/handbook/sales/engagements.md

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -46,12 +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.
88+
- 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)
5590
- Ensure the Deal Type is set up, "Expansion" is an in-term upsell
5691
2. Fill in the Buyer Information section. This will pre-fill with the
5792
information from the contact in the Deal.

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)