# id.sifa.profile.location

> Published by [sifa.id](https://lexicon.garden/identity/did:plc:2f2ahswozqy4v5lvu676375y)

✓ This is the authoritative definition for this NSID.

## Description

A location associated with the user's professional profile. Supports multiple locations per user (e.g. residential, business, travel).

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:2f2ahswozqy4v5lvu676375y/id.sifa.profile.location)
- [Documentation](https://lexicon.garden/lexicon/did:plc:2f2ahswozqy4v5lvu676375y/id.sifa.profile.location/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:2f2ahswozqy4v5lvu676375y/id.sifa.profile.location/examples)

## Definitions

### `id.sifa.profile.location`

**Type**: `record`

A single location entry in the user's profile.

**Key**: `tid`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `type` | `string` | Yes | The role of this location. |
| `label` | `string` | No | Optional user-defined label for this location. |
| `address` | `ref` → `community.lexicon.location.address` | Yes | Structured location address. Sifa enforces ISO 3166-1 alpha-2 country codes at the app layer. |
| `createdAt` | `string` (datetime) | Yes | Client-declared timestamp when this record was created. |
| `isPrimary` | `boolean` | No | Whether this is the primary/display location. |

## Raw Schema

```json
{
  "id": "id.sifa.profile.location",
  "defs": {
    "main": {
      "key": "tid",
      "type": "record",
      "record": {
        "type": "object",
        "required": [
          "address",
          "type",
          "createdAt"
        ],
        "properties": {
          "type": {
            "type": "string",
            "description": "The role of this location.",
            "knownValues": [
              "id.sifa.defs#locationPrimary",
              "id.sifa.defs#locationBusiness",
              "id.sifa.defs#locationTravel"
            ]
          },
          "label": {
            "type": "string",
            "maxLength": 600,
            "description": "Optional user-defined label for this location.",
            "maxGraphemes": 60
          },
          "address": {
            "ref": "community.lexicon.location.address",
            "type": "ref",
            "description": "Structured location address. Sifa enforces ISO 3166-1 alpha-2 country codes at the app layer."
          },
          "createdAt": {
            "type": "string",
            "format": "datetime",
            "description": "Client-declared timestamp when this record was created."
          },
          "isPrimary": {
            "type": "boolean",
            "description": "Whether this is the primary/display location."
          }
        }
      },
      "description": "A single location entry in the user's profile."
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1,
  "description": "A location associated with the user's professional profile. Supports multiple locations per user (e.g. residential, business, travel)."
}
```