# Cartrella Docs — full corpus

> Documentation for Cartrella — the Shopify app suite that collapses bundles, reviews, upsell, and loyalty into one platform: one account, one data graph, one bill.

# Getting started

Install Cartrella and turn on your first module.

Canonical: https://cartrella.com/docs/getting-started

## Install

Install Cartrella from the Shopify App Store (or your private install link). During install you approve the permissions Cartrella needs and pick a plan — one subscription covers every module you enable.

## Turn on a module

Open **Cartrella** in your Shopify admin. Each module — Bundles first, Reviews next — switches on from its own card. A module you have not enabled never loads a byte on your storefront.

## Add the storefront blocks

In the theme editor, add Cartrella's blocks where you want them (for example the pack picker on a product page). Blocks inherit your theme's fonts and colors by default — they should look like your store built them.

# Cartrella documentation

One suite for bundles, reviews, upsell, and loyalty — one account, one data graph, one bill.

Canonical: https://cartrella.com/docs/

Cartrella collapses the point-app stack merchants usually assemble — a bundles app, a reviews app, an upsell app, a loyalty app — into one Shopify suite on a shared platform.

## Start here

- **[Getting started](/getting-started)** — install Cartrella and turn on your first module.
- **[Bundles](/bundles)** — mix-and-match packs priced natively in checkout.

## For developers

The [API reference](/developers/api) is generated from the same OpenAPI contracts that drive the product — it cannot drift from the real API.

# Bundles

Mix-and-match packs, priced natively in checkout.

Canonical: https://cartrella.com/docs/bundles

Bundles lets shoppers build multi-item packs — fixed packs or mix-and-match — with pricing applied by a Shopify Function **inside checkout**. The price you configure is the price displayed, carted, and charged: there is no client-side math to drift.

## How pricing works

1. You configure pack sizes and discounts in the Cartrella admin.
2. Cartrella compiles the configuration and deploys it to a Cart Transform Function.
3. The storefront block renders the picker from the same configuration (display only).
4. Shopify runs the Function on every cart — checkout is the single pricing authority.

# API reference

Generated from the Cartrella OpenAPI contracts.

Canonical: https://cartrella.com/docs/developers/api

The reference below is generated from `contracts/openapi/*.v1.yaml` — the same contracts that generate the server stubs, the TypeScript SDK, and the copilot's tools.