> ## Documentation Index
> Fetch the complete documentation index at: https://docs.akua.dev/llms.txt
> Use this file to discover all available pages before exploring further.
# Offers
> Short customer URLs with selected inputs, access rules, and checkout flow
An Offer is a shareable URL (`akua.dev/i/`) that sends a customer into the generated install wizard for a Product or Package version. The wizard is rendered from the pinned Package version's input schema, so customers configure their install without a custom form.
## The flow
```mermaid theme={null}
flowchart TB
PKG["Package version
Input schema + @ui annotations"]
PRODUCT["Product
catalog metadata"]
OFFER["Offer
short hash + access rules"]
ORDER["Order draft
customer workspace + configuration"]
CHECKOUT["Checkout
optional payment"]
INSTALL["Installation
running in a workspace"]
PKG --> PRODUCT
PKG --> OFFER
PRODUCT --> OFFER
OFFER --> ORDER
ORDER --> CHECKOUT
CHECKOUT --> INSTALL
```
The customer opens the Offer, signs in if required, chooses or creates a workspace, fills the generated form, completes checkout when payment is required, and receives an installation. Each redemption is tracked as an [order draft](/marketplace/order-drafts) that moves through those states one at a time.
## What an Offer controls
| Control | What it does |
| ---------------------- | ----------------------------------------------------------------------------- |
| **Target and version** | Selects the Product or Package version used by the wizard |
| **Field values** | Pre-fills Package inputs and can lock fields the customer should not change |
| **Access** | Restricts redemption by email, expiry, maximum uses, or private customer flow |
| **Commercial terms** | Selects the payment or private-sale path allowed for this customer |
| **Support visibility** | Lets the seller understand where the customer is in the order flow |
Sensitive values are handled as write-only configuration. Saved offers should show that a value exists, not reveal secret material.
## Generated fields
Each Package input becomes a wizard field. Akua uses:
* KCL docstrings as help text.
* `@ui(order=...)` to sort fields.
* `@ui(group=...)` to group related fields.
* `@ui(widget=...)` for controls such as sliders, password fields, text areas, and selects.
* `@ui(placeholder=...)`, `@ui(min=...)`, and `@ui(max=...)` for form hints and bounds.
See [Package format](/akua/package-format#ui-annotations) for authoring details.
## Public catalog vs private offer
| Path | Use when |
| ----------------------- | --------------------------------------------------------------------------- |
| **Marketplace listing** | Customers should discover the Product publicly and start from the catalog. |
| **Reusable Offer** | You want a shareable campaign or partner URL with a specific configuration. |
| **Private Offer** | You want per-customer terms, email restrictions, expiry, or locked inputs. |
All paths create the same kind of [order draft](/marketplace/order-drafts) and installation. The difference is how much context the seller chooses before the customer starts.
To distribute offers through a partner, a private audience, or a beta cohort under reviewed pricing and approval terms, group them behind an [Offer channel](/marketplace/offer-channels). Channels are a restricted, request-only entitlement enabled per workspace by Akua.
## API
Create, inspect, archive, unarchive, and resolve offers.
Track customer configuration, workspace selection, checkout, and install progress.
Fetch Package versions and input schemas used by generated forms.
Set up API tokens for seller-side automation.
## Related topics
Track the customer flow started by an offer.
Sellable wrappers around Package versions.
Versioned install definitions and input schemas.
Configure commercial terms on the product an offer distributes.