> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.chrt.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.chrt.com/_mcp/server.

# FAQ

Common questions, grouped by topic. If you don't see your question, contact
[hi@chrt.com](mailto:hi@chrt.com).

## Orders and shipments

#### What's the difference between a draft, an order, and a task group?

A **draft** is an in-progress shipment you're building in the draft
builder — it isn't live until you submit. An **order** is the submitted
shipment that all parties can see and act on. A **task group** is one leg
of an order assigned to one provider — a single-leg ground order has one
task group, a ground + flight + ground shipment has three. See
[Orders](/docs/concepts/orders) for the full model.

#### How do I create my first shipment?

Open [chrt.com/orders/drafts/new](https://chrt.com/orders/drafts/new),
pick a forwarder or courier on the **Order setup** tab, add cargo, add
segments and stops, then submit from the **Preview** tab. The
[Creating shipments](/shippers/creating-shipments) guide walks through the
draft builder tab by tab.

#### Can I paste an email or quote and have chrt build the order for me?

Yes — the AI order builder lives on the **Order setup** tab of a new draft
and reads freeform text (emails, quotes, Slack threads) to populate cargo,
stops, and segments. Review every field before you submit. See
[AI order builder](/shippers/ai-order-builder).

#### How do multi-leg and next-flight-out shipments work?

Multi-leg orders use the **Segments** tab to chain a ground pickup, a
flight, and a ground recovery (or any mix). For NFO, search the **Flights**
tab with **Next 6 hr** to find the soonest commercial flight. See
[Multi-leg orders](/forwarders/multi-leg-orders) and
[Next flight out](/forwarders/nfo).

#### What's an off-platform provider?

A record of a forwarder or courier who isn't on chrt yet. You can still
build orders that reference them — you just won't get in-app dispatch and
updates from them. See [Off-platform providers](/shippers/off-platform).

## Tracking

#### Where do I see a shipment's live location?

Open the order at `/orders/<order-ref>` and switch to the **Map** tab.
Once the driver taps **Start driving** in the driver app, you'll see their
location update live alongside the planned route. See
[Tracking shipments](/shippers/tracking).

#### How are ETAs calculated?

chrt derives the ETA from the driver's live location plus Mapbox driving
directions, with a small buffer between tasks. Flight legs use FlightAware
actual / estimated / predicted / scheduled times in that priority order.
See [Tracking concept](/docs/concepts/tracking) for the full calculation.

#### How do I share tracking with a customer who isn't on chrt?

On the order, click **Actions** > **Share tracking** to generate a public
link at `https://chrt.com/orders/public/<order-ref>`. Recipients see the
live map without a chrt account. See
[Public tracking links](/shippers/public-tracking).

#### Can I revoke a public tracking link?

For orders, yes — reopen the **Share tracking** dialog and turn off all
segments. For standalone tracker sessions, no — once made public, the
session stays public until you delete it. See
[Public tracking links](/shippers/public-tracking).

## Billing and payouts

#### Why are there no line items on my statement?

The task group ran without a matching rate sheet. Confirm the connection
has a default rate sheet, or attach one directly to the task group. See
[Rate sheets](/shippers/rate-sheets) and
[Billing primitives](/docs/concepts/billing-primitives).

#### How do I adjust a line item I think is wrong?

Open the statement detail page, find the line item, and use the **Adjust**
dialog to enter the delta and a short comment. Adjustments leave an audit
trail. You can only adjust before the statement is paid — paid statements
are immutable. See [Billing](/shippers/billing).

#### What's a ledger?

A ledger groups statements over a defined billing period for one
connection — useful for weekly or monthly rolling invoicing instead of
settling one statement at a time. Open the period to roll outstanding
statements into a consolidated invoice. See
[Billing](/shippers/billing#4-manage-ledgers).

#### Do I need Stripe Connect?

You need a Stripe Connect account to **receive** payments through chrt's
payment processor. Shippers paying providers don't need Stripe Connect to
pay — chrt uses Stripe Checkout for that. Forwarders and couriers
typically need it on both sides. See
[Billing for forwarders](/forwarders/billing#5-set-up-stripe-connect).

#### What are SPP, PPD, and PPP rate sheets?

Three rate sheet kinds: **Standard per-piece**, **Per-piece per-distance**,
and **Per-piece per-pickup**. The kind you pick depends on how you price
work. See [Rate sheets](/shippers/rate-sheets) for field-by-field
breakdowns.

## Plans and pricing

#### Is it free to sign up?

Creating a shipper organization and connecting with a provider is free.
You only pay for the shipments you place. Provider organizations
(couriers and forwarders) go through subscription checkout during
onboarding. See [Getting started as a shipper](/shippers).

#### Where can I see what chrt costs?

Pricing details for provider subscriptions and trackers are at
[chrt.com](https://chrt.com). Contact [hi@chrt.com](mailto:hi@chrt.com)
if you need a custom plan.

## API and SDKs

#### Where's the API reference?

The full reference lives under the [API](/api) tab. Browse endpoints by
domain — orders, tracking, billing, connections, devices — each with
request and response schemas and code samples.

#### Which SDKs do you ship?

TypeScript, Swift, and Java SDKs are published from the API spec. See the
[SDKs](/sdk) page for install instructions and code samples in each
language.

#### How do I receive events in my own system?

Enable webhooks at [chrt.com/settings/webhooks](https://chrt.com/settings/webhooks),
then configure an HTTPS endpoint and subscribe it to the event types you
care about. Delivery is powered by Svix and includes signed payloads,
retries, and a delivery log. See
[Notifications](/shippers/notifications#3-webhooks).

## The chrt app

#### What's the chrt driver app for?

Drivers use the mobile app to receive assignments, share live location,
complete stops, and capture proof of delivery (photos, signatures,
barcodes). It's available for iOS and Android — install from
[chrt.com/driver-app](https://chrt.com/driver-app).

#### How do I invite a driver?

Drivers use the same invite flow as any other teammate. Open
[Members settings](https://chrt.com/settings/members), click **Invite
user**, and choose **Member** as the role — that's the right role for
anyone who only needs the driver app. See
[Add an organization member](/help/getting-started/add-org-member).

#### Does the driver app work offline?

The Android driver app has full offline mode — drivers can accept, work,
and capture POD without a connection, and changes sync when they come
back online. iOS does not currently have offline mode.

## Trackers

#### What's the difference between standalone and on-order trackers?

**Standalone** trackers run their own tracking sessions, independent of
any chrt order — good for one-off shipments or cargo on orders that live
outside chrt. **On-order** trackers attach to cargo on a chrt order and
show up alongside driver location on the order map. See
[Trackers overview](/trackers).

#### How long do tracking sessions run?

By default a session ends after 3 days. You can pick a specific
termination date, or choose **No auto termination** to keep recording
until you stop it manually. Longer or open-ended sessions may incur
additional charges. See [Standalone trackers](/trackers/standalone).

#### How long until I see the first ping after starting a session?

First pings typically appear within about 15 minutes. If nothing shows
after 30 minutes, contact [trackers@chrt.com](mailto:trackers@chrt.com).
See [Standalone trackers](/trackers/standalone).

#### How do I get trackers?

chrt does not sell trackers self-serve. Email
[trackers@chrt.com](mailto:trackers@chrt.com) to request devices, ask
about pricing, or check whether a specific model fits your operation.

## Account and security

#### How do I invite a teammate and what do the roles mean?

Open [Members settings](https://chrt.com/settings/members), click
**Invite user**, enter their email, and pick a role. **Owner** has full
access; **Admin** manages members, settings, and billing; **Operator** is
for dispatchers and coordinators; **Member** is for drivers and
limited-access teammates. See
[Add an organization member](/help/getting-started/add-org-member).

#### How does chrt handle my data?

Files are encrypted at rest with AES-GCM (256-bit), each with a unique
key wrapped by a rotated main key. All traffic uses HTTPS with TLS 1.3
(TLS 1.2 supported for older browsers). See [Security](/docs/security) for the
full breakdown.

## Branding

#### How do I pronounce chrt?

We usually say "chart", but "c-h-r-t" works too.

#### Where does the name chrt come from?

We ship bits and atoms, and the name has half its origin in each. In the
world of atoms, "chrt" is short for "chart", which originally meant "map
for the use of navigators" in the 1500s. In the world of bits, `chrt` is
the Linux command for manipulating the real-time scheduling attributes
of a process.