## Auctions

Use this page for auction concepts, placement inventory, bid rules, confirmation states, reporting paths, and the boundaries between seller bidding and admin-owned auction controls.

{% figure src="/docs-images/gitbook-products-auctions.png" alt="GitBook auctions product docs page" caption="The auctions product guide gives readers a public reference for bid flow, sponsored placement language, and reporting states before they depend on seller or admin auction surfaces." /%}

## What to document

Explain which auction surfaces are reader-facing, how bids are entered or reviewed, what status changes matter, and where sponsored placement language differs from standard catalog behavior. Readers should leave knowing the auction lifecycle without having to infer it from scattered app screens.

## Reporting

Document the important result states, ledger or reporting views, and any delays between bid activity and downstream analytics or invoice visibility.

## Source of truth

Confirm auction terminology against workflow specs and current Convex function paths before documenting settlement timing, win states, or admin overrides.