Promotions - Ruba Docs

Discounts reduce one-time or recurring prices. Build the commercial rule first, then choose whether checkout applies it silently or lets the buyer see a code.

Ruba promotions list in light mode

Ruba promotions list in dark mode

Ruba promotion creation form in light mode

Ruba promotion creation form in dark mode

Define the offer

Create it from Catalog → Promotions.

Setting	Decision
Name	Customer-facing label shown when applied
Code	Optional, case-insensitive entry value; without one, only links and API calls can apply it
Amount	Percentage reduction or fixed monetary reduction
Duration for recurring prices	First charge only, a fixed number of months, or indefinitely
Products	Limit eligibility, or leave unrestricted to include current and future products
Active window	Optional start and end timestamps
Maximum redemptions	Cap the number of successful applications

Choose the checkout path

Guaranteed campaign price

Preset the discount while creating a checkout page. Every buyer arriving through that page receives it without entering a code. This is also how a code-less discount is used outside the API.

Visible code prefill

Append discount_code to a checkout page URL. Ruba fills the form field, but the buyer still sees the value on checkout.

Server-selected price

Supply the discount while creating a Checkout Session. This keeps the decision in application logic; see Checkout Sessions.