Skip to main content

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.

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:
FieldDetails
Venue / business nameOptional. Shown as the display label when present (e.g., “Zilker Park”).
Street addressRequired. The full street address of the venue.
CityRequired. Must be a real city in the selected state, verified against OpenStreetMap.
StateRequired. Two-letter US state code.
Location descriptionOptional, up to 300 characters. Good for parking tips, gate codes, court details, or entrance notes.
Supported sportsRequired. At least one game from the full sports list. These are the games selectable when you use this location for a game.
Public / privateWhether other signed-in members can choose this location when they host.
Home address flagMarks the location as your home address. Home addresses cannot be made public.

Creating a location

1

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.
2

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.
3

Enter the street address

The Street address field also has address autocomplete. Selecting an address suggestion auto-populates the city and state fields.
4

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.
5

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.
6

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.
7

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.
8

Save

Click Save location. The location is immediately available in game creation dropdowns.

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.
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).

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.
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.

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.