> ## Documentation Index
> Fetch the complete documentation index at: https://docs.matchely.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Your venue's courts

> Register courts, build the price table, turn paid booking on, run the agenda and follow the finances.

An [organization](/en/competitions/organizations) can sell court time through
the app. Everything lives under **Menu → My organizations → your organization
→ Settings**, in six tabs: **General · Agenda · Courts · Pricing · Booking ·
Finance**. Only whoever administers the organization gets in.

The order of work is this: register the courts, build the prices, turn booking
on, and then live in the Agenda.

## Courts

**Add court** asks for a name, the **sports** it hosts (the same sand court can
serve beach tennis, volleyball and footvolley), the **surface** (sand, clay,
hard, grass, synthetic, wood or other), the features (**covered**, **lights**,
**indoor**), the player capacity (optional) and a photo.

**Opening hours** are per weekday: tap a day to open or close it, adjust the
window, or use **Apply to every day**. Each day takes up to six windows of at
least one hour. **Closures** take the court off the grid for a period
(maintenance, private event, holiday), with a reason.

<Tip>
  A court that goes out of use does not need deleting: **Court inactive**
  removes it from the grid and the organization page without erasing anything.
  A court with upcoming bookings cannot be deleted at all — the app asks you to
  deactivate it.
</Tip>

Each organization registers up to 30 courts. They show on the organization's
public page, with the weekly hours.

<Frame caption="The Courts tab: each card carries sports, features and the hours grouped by identical days; the inactive one is dimmed with a label. (Screens are shown in Portuguese.)">
  <img className="block dark:hidden" src="https://mintcdn.com/matchely/fYn8PXTzrT7KVVVI/images/ds/quadras/arena-quadras-light.png?fit=max&auto=format&n=fYn8PXTzrT7KVVVI&q=85&s=86ab374b2d1396649f5e472d3c250cd9" alt="Courts tab of the venue settings, with the 4/30 counter, four court cards with photo, sports, features and opening hours, one of them inactive, and the Add court button" width="430" height="1060" data-path="images/ds/quadras/arena-quadras-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/matchely/fYn8PXTzrT7KVVVI/images/ds/quadras/arena-quadras-dark.png?fit=max&auto=format&n=fYn8PXTzrT7KVVVI&q=85&s=a621660b129da842523ea2bdadc675da" alt="Courts tab of the venue settings, with the 4/30 counter, four court cards with photo, sports, features and opening hours, one of them inactive, and the Add court button" width="430" height="1060" data-path="images/ds/quadras/arena-quadras-dark.png" />
</Frame>

## Pricing

A price rule covers **court × weekdays × time range × duration**. With no
duration, the price is per hour and applies proportionally to any duration;
with one, the rule covers that duration only. Each rule can carry a **member
price**, which the organization's members see instead of the standard one.

When more than one rule covers the same time, the highest **priority** wins;
on a tie, the lower price. The **How much does it cost?** panel simulates a
combination of court, day, start and duration, and the **Open hours with no
price** list shows what is left uncovered.

<Warning>
  A time with no price rule **cannot be sold**: the player sees a dimmed cell
  and cannot book. Check the coverage before turning booking on.
</Warning>

## Booking

The **Booking** tab is where paid booking is turned on and off. To turn it on,
the app requires four things, and lists what is missing:

* the organization has a manager;
* the **organization owner has connected Mercado Pago** (that is the account
  the money lands in);
* the **time zone** is set — the app detects it from the address under
  General, or you type it in;
* the **cancellation policy** is filled in.

The other settings:

* **Grid step** (30 or 60 minutes) and **sellable durations**, which must be
  multiples of the step.
* **Booking window**: how far ahead a player can book (1 to 180 days).
* **Minimum notice**: how close to the start a player can still book.
* **Cancellation policy**: how many hours before the start a player can cancel
  with a full refund, plus a note they read before paying. After the deadline
  there is no refund. The policy that applies to each booking is the one
  published **when the player paid** — changing it later does not reach
  whoever already booked.
* **Split between players**: whether a player can split the cost, and the
  **share deadline** (hours before the start). Whoever books is the guarantor:
  whatever is missing at the deadline becomes a charge to them, and if they do
  not settle it by 2 hours before the start the booking falls, with a full
  refund to everyone.

<Note>
  For now paid booking works only in Brazilian reais (BRL), through Mercado
  Pago. The gateway fee is on the organization and is not returned in any
  refund. Matchely charges nothing on bookings.
</Note>

## Agenda

The **Agenda** shows the week (or the day) of one court or all of them, with
the legend: player booking, walk-in booking, block and held slot (payment in
progress). Tapping a free slot offers two actions:

* **Block** — takes the court off the grid for every sport, with a reason
  (maintenance, lesson, event). It can **repeat every week** until a date,
  skipping taken slots or not.
* **Manual booking** — for whoever called or walked in. A Matchely player (by
  name or @username) or a free-text name, sport, start, duration and the
  **agreed amount**, which comes from your price rules and can be edited. It
  does not go through payment in the app: settle it at the venue.

Tapping a booking opens its details — who booked, participants, status,
source, amount, paid and refunded, the player's note — and **Cancel booking**.
Cancelling asks for a reason (the player sees it) and brings the **Refund the
amount paid** switch, on by default: a cancellation by the venue refunds **in
full, even past the policy deadline**. Turned off, the app refunds nothing and
settling it is on you. On a weekly block, you can remove just that occurrence
or that one and the future ones.

<Frame caption="One court's week: a player booking, a walk-in booking, a block and a slot held while someone pays.">
  <img className="block dark:hidden" src="https://mintcdn.com/matchely/fYn8PXTzrT7KVVVI/images/ds/quadras/arena-agenda-light.png?fit=max&auto=format&n=fYn8PXTzrT7KVVVI&q=85&s=73758d8424a2dc26804d7eab8dad8ea6" alt="Agenda tab in week view: period navigation, Today button, Day and Week pills, court selector and the seven-day grid with player booking, walk-in booking, block and held slot, with the legend below" width="940" height="934" data-path="images/ds/quadras/arena-agenda-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/matchely/fYn8PXTzrT7KVVVI/images/ds/quadras/arena-agenda-dark.png?fit=max&auto=format&n=fYn8PXTzrT7KVVVI&q=85&s=dfaa9a8c4e139dfa2195e1700c9b3e3f" alt="Agenda tab in week view: period navigation, Today button, Day and Week pills, court selector and the seven-day grid with player booking, walk-in booking, block and held slot, with the legend below" width="940" height="934" data-path="images/ds/quadras/arena-agenda-dark.png" />
</Frame>

## Finance

The **Finance** tab adds up what the bookings moved in the period (this month,
last month or custom), for one court or all: **Gross**, gateway **Fee**,
**Estimated net**, **Refunded** and **Shares pending** from splits. A booking's
fee may arrive after the payment, and the net goes down when it does — the
panel says how many are still missing.

**Download spreadsheet** exports the period with date and time, court, owner,
participants, source, status, gross, fee, net and refunded. The official
statement is the **Mercado Pago** one, linked from the tab itself.

<Frame caption="The month's Finance: the five totals, with the estimated net highlighted and the notice about the fee that has not arrived yet, and the list of bookings with each one's money.">
  <img className="block dark:hidden" src="https://mintcdn.com/matchely/fYn8PXTzrT7KVVVI/images/ds/quadras/arena-financeiro-light.png?fit=max&auto=format&n=fYn8PXTzrT7KVVVI&q=85&s=49e954626c22148d60a97b6f6937df4d" alt="Finance tab of the venue settings: period and court pills, the Gross, Fee, Estimated net, Refunded and Shares pending totals, the list of the period's bookings with amount, fee and net per row, and the Statement on Mercado Pago and Download spreadsheet buttons" width="430" height="1848" data-path="images/ds/quadras/arena-financeiro-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/matchely/fYn8PXTzrT7KVVVI/images/ds/quadras/arena-financeiro-dark.png?fit=max&auto=format&n=fYn8PXTzrT7KVVVI&q=85&s=330a73f623bd7867d54534e6b7c4eb37" alt="Finance tab of the venue settings: period and court pills, the Gross, Fee, Estimated net, Refunded and Shares pending totals, the list of the period's bookings with amount, fee and net per row, and the Statement on Mercado Pago and Download spreadsheet buttons" width="430" height="1848" data-path="images/ds/quadras/arena-financeiro-dark.png" />
</Frame>

<CardGroup cols={2}>
  <Card title="Book a court" icon="calendar-check" href="/en/courts/book">
    What the player sees: grid, payment, split and cancellation.
  </Card>

  <Card title="Organizations" icon="building" href="/en/competitions/organizations">
    Creating the organization, its page and the team.
  </Card>
</CardGroup>
