What Is billingIncrement Schema?

Published
Updated
11 min read

billingIncrement defines the measurable step used to calculate a usage-based charge for SaaS, APIs, cloud resources, credits, telecommunications, and other metered services.

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.

  1. Frame the decision raised by What Is billingIncrement Schema.
  2. Confirm its value type and the object it describes.
  3. Compare the markup with visible page information.
  4. Correct the source data or template without inventing values.
  5. Validate the rendered result and monitor future changes.
billingIncrement at a glance
QuestionPractical answerExample
What does it describe?The step size used for billing1,000 requests
Where is it used?UnitPriceSpecificationUsage-based offer terms
Why does it matter?It reveals pricing granularityPartial 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
Parts of an incremental price
ElementMeaningAPI example
priceCharge associated with the priced unit0.50
priceCurrencyCurrency used for the chargeUSD
billingIncrementUsage step used for billing1,000 requests
OfferThe purchasable commercial termsMetered API plan
  1. Define the measured usage dimension.
  2. Set the exact step used by invoicing.
  3. Connect it to the corresponding unit price.
  4. 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.

  1. Frame the decision raised by When Should You Use billingIncrement.
  2. Confirm its value type and the object it describes.
  3. Compare the markup with visible page information.
  4. Correct the source data or template without inventing values.
  5. Validate the rendered result and monitor future changes.
Suitable billingIncrement use cases
ServiceIncrementVisible pricing phrase
SEO API1,000 requests$0.50 per 1,000 calls
Cloud storage100 GB-month$2 per 100 GB-month
Call service1 minute$0.04 per minute
Crawl platform10,000 URLs$8 per 10,000 crawled URLs
Fulfillment1 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
Choosing a clear increment
Pricing statementIncrement valueRequired context
$0.50 per 1,000 requests1000Requests
$0.04 per minute1Minute
$8 per 10,000 URLs10000Crawled URLs
$2 per 100 GB-month100GB-month
  1. Copy the increment from the canonical pricing configuration.
  2. Confirm its measurement dimension.
  3. Use the same unit in visible copy and calculators.
  4. 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
  1. Frame the decision raised by How Do You Add billingIncrement in JSON-LD.
  2. Confirm its value type and the object it describes.
  3. Compare the markup with visible page information.
  4. Correct the source data or template without inventing values.
  5. Validate the rendered result and monitor future changes.
JSON-LD implementation review
CheckPass conditionFailure example
PlacementProperty belongs to the correct price specificationPlaced on an unrelated Organization
ValueMatches the invoice stepMarkup says 100 while billing uses 1,000
Unit contextCustomer can identify the measured usageIncrement 10 with no meaning
CurrencyMatches the relevant offer marketUSD 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
  1. Frame the decision raised by billingIncrement vs referenceQuantity: What Is the Difference.
  2. Confirm its value type and the object it describes.
  3. Compare the markup with visible page information.
  4. Correct the source data or template without inventing values.
  5. Validate the rendered result and monitor future changes.
billingIncrement compared with referenceQuantity
DimensionbillingIncrementreferenceQuantity
Main questionIn what steps does the charge advance?What amount is the unit price expressed per?
Primary purposeBilling granularityComparable rate
Storage example10 GB blocksPrice per 100 GB
Main riskHiding rounding behaviorUsing 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
Boundary behavior examples
UsageRuleBilled quantityDisclosure needed
999 requestsRound up by block1 blockMinimum one block
1,001 requestsRound up by block2 blocksPartial blocks round upward
1,001 requestsProrated1.001 blocksUsage is billed proportionally
0 requestsMonthly minimumDefined minimumMinimum charge applies
  1. Test zero usage and the first billable amount.
  2. Test one unit below and above each boundary.
  3. Test tier transitions and promotional credits.
  4. 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.

  1. Frame the decision raised by How Do You Validate billingIncrement Markup.
  2. Confirm its value type and the object it describes.
  3. Compare the markup with visible page information.
  4. Correct the source data or template without inventing values.
  5. Validate the rendered result and monitor future changes.
Validation workflow for incremental pricing
LayerEvidencePass condition
SyntaxParsed JSON-LDValue is valid and graph is well formed
ModelEntity relationshipIncrement belongs to the intended price specification
ConfigurationLive billing settingsMarkup value equals canonical increment
BoundaryUsage test casesCalculated blocks match billing logic
PageVisible pricing copyIncrement and unit are understandable
InvoiceReal or sandbox chargePayable 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.