Search & places

Write great place descriptions

All guides

A place's Description is one field doing two jobs: it's the text a visitor reads on the card, and it's part of the hidden text that search matches against. Writing with both in mind gets you a card that reads well and a place that's easy to find.

Where the description shows up

PlaceHow it appears
The place cardIn full, below the buttons, with your paragraph breaks preserved.
Under the name in the listAs a short snippet — only if Show description under names is on.
SearchThe whole description is searched, whether or not it's displayed.

Write the first line to stand alone

When shown under a name in the list, the description is trimmed to a short snippet. Lead with the most useful words — what the place is and why a visitor cares — so the snippet still makes sense on its own. Save the detail for later sentences.

Because the description feeds search, it's the natural home for keywords that don't belong in a short name — brands stocked, cuisines, services, alternative names. A stall called "Green Bowl" that mentions "vegan, vegetarian, gluten-free" in its description will surface for any of those searches without cluttering its name.

Everyday facility words are already covered by built-in synonyms (loo→toilet, medic→first aid, and so on), so you don't need to list those. Focus on the words that are specific to your places.

Formatting: paragraphs and basic HTML

The description keeps the line breaks you type, so pressing Enter for a new paragraph shows as a real break on the card. You can also use basic HTML — for example <b>bold</b> for emphasis or a <br> for a single line break. Both ways of breaking a line land the same on the card.

Keep formatting light. The card is a compact popup, so short paragraphs and the occasional bit of bold read far better than long blocks or heavy markup.

A quick checklist

  1. Lead with the essentials

    The first line should make sense as a standalone snippet.

  2. Add the searchable extras

    Brands, cuisines, services and alternative names a visitor might type.

  3. Break it into short paragraphs

    Press Enter between them; the breaks are kept.

  4. Keep it tight

    A card is small — a few short sentences beats an essay.