> For the complete documentation index, see [llms.txt](https://docs.tiun.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tiun.io/reference/generic/products.md).

# Products

Everything you sell on tiun is modeled as a **product**. tiun has two product types, and each matches a different pricing and access pattern.

***

## Subscription

Subscriptions charge users on a **fixed schedule** — monthly, quarterly, or yearly. You configure the **interval**, the **recurring fee**, and optionally a **trial period** with a **trial amount** (use a trial amount of zero for a free trial).

Subscriptions fit SaaS, membership sites, and any product where access is continuous and priced like a membership.

<figure><img src="/files/adr4KK338e8oNP1Xczqq" alt="Create product form for subscription with interval, fee, and trial settings" width="340"><figcaption><p>Creating a subscription product.</p></figcaption></figure>

Subscription products integrate through `tiun.checkout({ productId })`. See [Checkout / How it works](/reference/checkout/how-it-works.md) and [Subscriptions](/reference/checkout/subscriptions.md) for the flow.

***

## Time-based billing

Time-based billing charges for **time spent** with your content rather than a flat membership. You define how often tiun charges (the **interval**), how much each interval costs (**interval fee**), and optionally a **monthly limit** that caps total spending.

Time-based products fit news, podcasts, video streaming, magazines — anywhere value tracks engagement.

<figure><img src="/files/y7CprLT3MA61sbEKv0X9" alt="Create product form for time-based billing with interval, fee, and monthly limit" width="340"><figcaption><p>Creating a time-based product.</p></figcaption></figure>

Time-based products integrate through `tiun.start()`. See [Time-based / How it works](/reference/time-based/how-it-works.md) for the flow.

***

## Product IDs

Every product gets a **unique product ID** like `p-live-pro`. The ID is stable and used everywhere you reference the product: `tiun.checkout()`, entitlement checks, analytics correlation.

Live and sandbox are **independent parallel catalogs** — you create products in each environment separately, and IDs never cross over. Product IDs are prefixed by environment: `p-live-...` for live and `p-test-...` for sandbox. See [Sandbox](/reference/generic/sandbox.md) for how the two environments work.

Find a product's ID on its detail or edit page in the [my.tiun.business dashboard](https://my.tiun.business/).

***

## Mix and match

A single tiun account can include **multiple product types** at once — for example a subscription for your core SaaS and a time-based offering for premium media. Each product is configured and called independently.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.tiun.io/reference/generic/products.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
