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

# Saved locations: create and reuse your venues

> Save venues once and reuse them across all your games. Covers supported sports, home address use, public or private visibility, and address privacy.

A saved location is a reusable venue record that you attach to games when hosting. Instead of typing the same park or gym address every time, you save it once and pick it from a dropdown. Locations also define which sports can be played there, which filters the game picker so you only see relevant options.

You can create locations in two ways: inline from the game creation form, or from the dedicated **Manage Locations** page at `/host/locations`.

***

## What a location stores

Each saved location contains:

| Field                 | Details                                                                                                                      |
| --------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| Venue / business name | Optional. Shown as the display label when present (e.g., "Zilker Park").                                                     |
| Street address        | Required. The full street address of the venue.                                                                              |
| City                  | Required. Must be a real city in the selected state, verified against OpenStreetMap.                                         |
| State                 | Required. Two-letter US state code.                                                                                          |
| Location description  | Optional, up to 300 characters. Good for parking tips, gate codes, court details, or entrance notes.                         |
| Supported sports      | Required. At least one game from the full sports list. These are the games selectable when you use this location for a game. |
| Public / private      | Whether other signed-in members can choose this location when they host.                                                     |
| Home address flag     | Marks the location as your home address. Home addresses cannot be made public.                                               |

***

## Creating a location

<Steps>
  <Step title="Open the location form">
    **From the game creation form:** Select **Create a new location** from the location dropdown. A dialog opens inline without leaving the form.

    **From Manage Locations:** Go to `/host/locations` and click **New location**. The same form opens as a dialog.
  </Step>

  <Step title="Enter the venue name (optional)">
    The **Venue / business name** field has address autocomplete. As you type, it suggests matching venues and auto-fills the street address, city, and state when you select a result. You can also type a name without selecting a suggestion.

    If you leave this field blank, the location label is built from the street address and city/state instead.
  </Step>

  <Step title="Enter the street address">
    The **Street address** field also has address autocomplete. Selecting an address suggestion auto-populates the city and state fields.
  </Step>

  <Step title="Enter city and state">
    The city is validated against the selected state when you leave the field (on blur). A spinner shows while the check runs, and a checkmark confirms the city is valid. If the city cannot be found in the state, an error message appears and the form will not save until it is corrected.
  </Step>

  <Step title="Add a description (optional)">
    Up to 300 characters. Players see this on the game detail page if they are approved. Good uses: parking tips, gate codes, court layout notes.
  </Step>

  <Step title="Select supported sports">
    Open the sports picker and check every game that can realistically be played at this location. You must select at least one. When a host uses this location, only the sports you check here appear in the game picker.
  </Step>

  <Step title="Set visibility">
    Check **Make this location public** if you want other signed-in members to be able to use this venue when they host their own games. Leave it unchecked to keep the location private to your account.

    Home addresses cannot be made public — the checkbox is disabled automatically when the home address flag is set.
  </Step>

  <Step title="Save">
    Click **Save location**. The location is immediately available in game creation dropdowns.
  </Step>
</Steps>

### Using your home address

If you have a verified home address on your profile, a **Use my home address** button appears at the top of the location form. Clicking it fills in the address, city, and state from your profile and marks the location as a home address. The city check is skipped because your profile address is already verified.

<Warning>
  Home address locations default to `is_home_address: true` and can never be set to public. They are visible only to you and members you explicitly share your home address with (housemates).
</Warning>

***

## Address privacy

Every location has an **address privacy** toggle that you can also control per game. When **Hide address until approved** is on for a game, the street address is hidden from everyone except you and approved players. Unapproved or waitlisted players see only the city/state and the note: *"The host has hidden the exact address. Once they approve your request to join, the full address will appear here."*

This toggle is set per game, not per location. When you select a home address location for a game, the per-game toggle turns on automatically.

***

## Editing and deleting locations

### Editing

On the Manage Locations page, click the pencil icon on any of your locations to open the edit dialog. All fields are editable except the street address, city, and state of home address locations — to change those, update your home address in your profile settings.

When you save an edit, all future games using this location pick up the updated details. Games already created keep the address they were created with.

### Deleting

Click the trash icon to delete a location. A confirmation dialog appears before anything is removed.

<Warning>
  You cannot delete a location that has been used in any game. The delete button is disabled and shows a tooltip explaining why. If you need to retire a venue, leave it in place — it will not appear in new game dropdowns once you stop selecting it.
</Warning>

***

## Public locations

When you mark a location as public, other signed-in members see it in the **Public locations from the community** section of their Manage Locations page. They can select it when creating their own games, but they cannot edit or delete it — only you can modify locations you created.

If another member's public location is visible to you, you can use it for your games but all edits remain with the original creator.
