What Is billingIncrement Schema?
billingIncrement states the discrete quantity step used to calculate a unit-based charge in UnitPriceSpecification. It can clarify that usage is billed in blocks such as every 1 minute, 1,000 API requests, 100 gigabytes, or 10 crawl credits rather than as an infinitely divisible amount.
The property explains pricing granularity. A service may quote a unit price but calculate charges only after usage crosses a fixed increment. Without that detail, “$2 per unit” can appear more precise than the actual billing system.
- Frame the decision raised by What Is billingIncrement Schema.
- Confirm its value type and the object it describes.
- Compare the markup with visible page information.
- Correct the source data or template without inventing values.
- Validate the rendered result and monitor future changes.
| Question | Practical answer | Example |
|---|---|---|
| What does it describe? | The step size used for billing | 1,000 requests |
| Where is it used? | UnitPriceSpecification | Usage-based offer terms |
| Why does it matter? | It reveals pricing granularity | Partial blocks may round to a full block |
- Use the same increment applied by the billing engine.
- Explain the measurement unit visibly on the page.
- Keep price, currency, increment, and rounding logic aligned.
The definition is operational: billingIncrement tells systems the measurable step at which a unit charge advances.
How Does billingIncrement Work With UnitPriceSpecification?
billingIncrement works inside UnitPriceSpecification by defining the usage block associated with a unit charge. The price identifies the monetary amount, while the increment identifies how much measured usage constitutes one billing step.
Suppose an API plan charges $0.50 per 1,000 requests. The unit price specification can carry the price and currency, while billingIncrement represents the 1,000-request step. Visible pricing copy still needs to explain whether 1,001 requests become two blocks or whether charges are prorated.
- Evidence for How Does billingIncrement Work With UnitPriceSpecification: the live structured-data entity and property relationship
- The expected value type and any nested object
- Visible page information that supports the structured value
- Related offer or catalog fields needed for interpretation
- A fresh validation result after the page changes
| Element | Meaning | API example |
|---|---|---|
| price | Charge associated with the priced unit | 0.50 |
| priceCurrency | Currency used for the charge | USD |
| billingIncrement | Usage step used for billing | 1,000 requests |
| Offer | The purchasable commercial terms | Metered API plan |
- Define the measured usage dimension.
- Set the exact step used by invoicing.
- Connect it to the corresponding unit price.
- Disclose rounding or minimum charges in visible terms.
Start with UnitPriceSpecification Schema for the parent model.
The two values must travel together: a unit price without its real billing step can misstate the cost customers incur.
When Should You Use billingIncrement?
Use billingIncrement when a product or service charges in fixed measurable steps and the step affects how customers understand the price. Strong use cases include cloud compute, API calls, storage, telecommunications, utilities, advertising, fulfillment, subscriptions with metered overages, and SEO software credits.
Do not use it for a simple flat monthly subscription with no increment-based usage charge. It should describe a real billing mechanism, not a marketing bundle or an internal metering detail that never affects the customer.
- Frame the decision raised by When Should You Use billingIncrement.
- Confirm its value type and the object it describes.
- Compare the markup with visible page information.
- Correct the source data or template without inventing values.
- Validate the rendered result and monitor future changes.
| Service | Increment | Visible pricing phrase |
|---|---|---|
| SEO API | 1,000 requests | $0.50 per 1,000 calls |
| Cloud storage | 100 GB-month | $2 per 100 GB-month |
| Call service | 1 minute | $0.04 per minute |
| Crawl platform | 10,000 URLs | $8 per 10,000 crawled URLs |
| Fulfillment | 1 package | $1.20 per handled package |
- Use it when the increment appears in customer-facing terms.
- Do not confuse it with plan allowances or usage limits.
- Avoid publishing internal technical units customers never purchase.
The decision rule is customer impact: add billingIncrement when the step changes how the payable amount is calculated.
What Value and Unit Should billingIncrement Use?
billingIncrement should use the numeric step and measurement meaning that the billing engine applies, expressed consistently with the associated unit price. A bare number is insufficient when readers cannot tell whether it represents seconds, requests, credits, bytes, or another quantity.
Schema implementations may represent commercial meaning through the surrounding UnitPriceSpecification and related quantity properties. The page should state the unit plainly even when the machine-readable graph uses a compact numeric increment.
- Evidence for What Value and Unit Should billingIncrement Use: the live structured-data entity and property relationship
- The expected value type and any nested object
- Visible page information that supports the structured value
- Related offer or catalog fields needed for interpretation
- A fresh validation result after the page changes
| Pricing statement | Increment value | Required context |
|---|---|---|
| $0.50 per 1,000 requests | 1000 | Requests |
| $0.04 per minute | 1 | Minute |
| $8 per 10,000 URLs | 10000 | Crawled URLs |
| $2 per 100 GB-month | 100 | GB-month |
- Copy the increment from the canonical pricing configuration.
- Confirm its measurement dimension.
- Use the same unit in visible copy and calculators.
- Test boundaries immediately below and above one increment.
Context completes the number: an increment is accurate only when its measurement unit and pricing relationship are unmistakable.
How Do You Add billingIncrement in JSON-LD?
Add billingIncrement to the relevant UnitPriceSpecification and keep that specification attached to the actual Offer. Generate the value from the same pricing configuration used by checkout or invoicing so the markup cannot drift from payable terms.
{
"@context": "https://schema.org",
"@type": "Offer",
"name": "Metered SEO API usage",
"priceSpecification": {
"@type": "UnitPriceSpecification",
"price": "0.50",
"priceCurrency": "USD",
"billingIncrement": 1000,
"unitText": "API requests"
}
}- Evidence for How Do You Add billingIncrement in JSON-LD: the live structured-data entity and property relationship
- The expected value type and any nested object
- Visible page information that supports the structured value
- Related offer or catalog fields needed for interpretation
- A fresh validation result after the page changes
- Frame the decision raised by How Do You Add billingIncrement in JSON-LD.
- Confirm its value type and the object it describes.
- Compare the markup with visible page information.
- Correct the source data or template without inventing values.
- Validate the rendered result and monitor future changes.
| Check | Pass condition | Failure example |
|---|---|---|
| Placement | Property belongs to the correct price specification | Placed on an unrelated Organization |
| Value | Matches the invoice step | Markup says 100 while billing uses 1,000 |
| Unit context | Customer can identify the measured usage | Increment 10 with no meaning |
| Currency | Matches the relevant offer market | USD page with EUR price specification |
Use Novaverb Site Audit to inspect the deployed graph across every pricing template.
The implementation should come from billing truth: do not hand-maintain a second increment solely for structured data.
billingIncrement vs referenceQuantity: What Is the Difference?
billingIncrement defines the step at which charges advance, while referenceQuantity defines the denominator used to express a normalized unit price. An increment concerns billing granularity; a reference quantity concerns price comparison.
A storage service might advertise $2 per 100 GB, making 100 GB the reference basis. If invoices advance in 10 GB blocks, the billing increment is 10 GB. These values answer different questions and can coexist when the commercial terms genuinely require both.
- Evidence for billingIncrement vs referenceQuantity: What Is the Difference: the live structured-data entity and property relationship
- The expected value type and any nested object
- Visible page information that supports the structured value
- Related offer or catalog fields needed for interpretation
- A fresh validation result after the page changes
- Frame the decision raised by billingIncrement vs referenceQuantity: What Is the Difference.
- Confirm its value type and the object it describes.
- Compare the markup with visible page information.
- Correct the source data or template without inventing values.
- Validate the rendered result and monitor future changes.
| Dimension | billingIncrement | referenceQuantity |
|---|---|---|
| Main question | In what steps does the charge advance? | What amount is the unit price expressed per? |
| Primary purpose | Billing granularity | Comparable rate |
| Storage example | 10 GB blocks | Price per 100 GB |
| Main risk | Hiding rounding behavior | Using the package amount as denominator |
Compare the full definition in referenceQuantity Schema.
Remember “step” versus “per”: billingIncrement defines the charging step; referenceQuantity defines the comparison basis.
How Do Rounding and Minimum Charges Affect billingIncrement?
Rounding and minimum-charge rules determine what happens when usage does not land exactly on a billing increment. Structured data should never imply smooth prorating when the invoice rounds partial blocks upward, enforces a minimum number of blocks, or uses tier-specific treatment.
If 1,001 requests are billed as two 1,000-request blocks, the page must say so clearly. If the platform charges the exact fractional amount, the increment should not falsely suggest block rounding. Customer-facing examples are often the clearest way to remove ambiguity.
- Evidence for How Do Rounding and Minimum Charges Affect billingIncrement: the live structured-data entity and property relationship
- The expected value type and any nested object
- Visible page information that supports the structured value
- Related offer or catalog fields needed for interpretation
- A fresh validation result after the page changes
| Usage | Rule | Billed quantity | Disclosure needed |
|---|---|---|---|
| 999 requests | Round up by block | 1 block | Minimum one block |
| 1,001 requests | Round up by block | 2 blocks | Partial blocks round upward |
| 1,001 requests | Prorated | 1.001 blocks | Usage is billed proportionally |
| 0 requests | Monthly minimum | Defined minimum | Minimum charge applies |
- Test zero usage and the first billable amount.
- Test one unit below and above each boundary.
- Test tier transitions and promotional credits.
- Compare the expected amount with an actual invoice calculation.
The increment alone cannot explain rounding: disclose boundary behavior wherever it can change the bill.
How Do You Validate billingIncrement Markup?
Validate billingIncrement by checking syntax, entity placement, pricing configuration, boundary calculations, rendered visibility, and invoice agreement. The strongest evidence is not a green parser result but a reproducible bill for representative usage amounts.
- Frame the decision raised by How Do You Validate billingIncrement Markup.
- Confirm its value type and the object it describes.
- Compare the markup with visible page information.
- Correct the source data or template without inventing values.
- Validate the rendered result and monitor future changes.
| Layer | Evidence | Pass condition |
|---|---|---|
| Syntax | Parsed JSON-LD | Value is valid and graph is well formed |
| Model | Entity relationship | Increment belongs to the intended price specification |
| Configuration | Live billing settings | Markup value equals canonical increment |
| Boundary | Usage test cases | Calculated blocks match billing logic |
| Page | Visible pricing copy | Increment and unit are understandable |
| Invoice | Real or sandbox charge | Payable total matches the disclosed method |
- Check every plan with a different usage unit.
- Test annual, monthly, trial, and overage variants.
- Re-crawl after pricing configuration changes.
- Flag pages where markup and visible increments disagree.
Connect pricing-page evidence with the broader Novaverb SEO tools system.
Start with a relevant free SEO check, continue the evidence workflow in Novaverb, and review pricing when comparing continuous monitoring with a one-time manual review.
Validation ends at the invoice: the structured increment is correct only when it predicts the same charge a customer receives.