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

# URL structure and SEO

> How Supadir organizes your catalog's URLs and what it means for search engine ranking.

URL structure is one of the foundational SEO signals Google uses to understand what a page is about. Supadir handles this automatically, but it helps to understand the system — especially when creating listings and entity types.

## Your catalog's URL structure

| Page                | URL pattern              | Example                                                    |
| ------------------- | ------------------------ | ---------------------------------------------------------- |
| Homepage            | `/`                      | `warsaw-physio.supadir.com/`                               |
| All listings        | `/listing`               | `warsaw-physio.supadir.com/listing`                        |
| Filtered by type    | `/listing?entity_type=1` | —                                                          |
| Individual profile  | `/s/{slug}`              | `warsaw-physio.supadir.com/s/anna-kowalska`                |
| Specialization page | `/specialization/{slug}` | `warsaw-physio.supadir.com/specialization/sports-injuries` |

## Profile slugs — how they're generated

When a new listing is created, Supadir auto-generates a URL slug from the listing's name:

* `Anna Kowalska` → `/s/anna-kowalska`
* `PhysioPlus Warsaw` → `/s/physioplus-warsaw`
* If a slug is already taken, a suffix is added: `/s/anna-kowalska-2`

<Info>
  Profile slugs are set when the listing is created and don't change automatically when you edit the name. This protects existing indexed URLs.
</Info>

## What Google sees on a profile page

Each profile page includes structured data (JSON-LD schema) that Google uses for rich results:

* **Person** or **LocalBusiness** schema — name, description, address, contact
* **BreadcrumbList** — the path from homepage to this profile

This means Google can display your listing's address, phone number, or star rating directly in search results without the user even clicking through.

## Internal linking for SEO

Supadir automatically creates internal links throughout your catalog:

* Specialization tags on profile pages link to the specialization filter page
* "Recently added" and "Featured" sections on the homepage link to profiles
* Navigation links connect listing type pages together

This web of internal links helps Google discover and index all your profiles faster.

## What this means for you practically

**Name listings clearly.** A listing named "Anna Kowalska – Physiotherapist" generates a better slug (`/s/anna-kowalska-physiotherapist`) than just "Anna" (`/s/anna`). The slug is part of Google's ranking signal for that page.

**Use real specialization names.** Specializations become URL slugs too (`/specialization/sports-injuries`). Write them as you'd expect someone to search for them.

**Don't rename the entity type too often.** The entity type name appears in headings and content across many pages. Frequent renames can create inconsistency that confuses both users and crawlers.

<Tip>
  The most powerful SEO move for your catalog long-term is getting more listings. Each profile page is an additional indexed page targeting keywords like "\[Profession Name] \[City]". 50 well-filled profiles beat any meta tag optimization.
</Tip>