# Set locale values

Source: https://developers.swell.is/backend-api/localization/set-locale-values

Use the format `$locale: { <code>: { <field>: value } }` with any `PUT` or `POST` request. For nested values, the `$locale` parameter must be defined on the nearest parent object.

All locale content is optional using this API, even if the setting **Require content for this locale** is enabled in the Swell dashboard.

## Example request

**Example setting localized content**

**cURL**

```bash
$ curl https://api.swell.store/products/5cad15bc9b14d1990724663a \
  -u store-id:secret-key \
  -d name="Test product" \
  -d $locale[fr][name]="Test produit" \
  -d $locale[fr][tags]="étiqueter1, étiqueter2" \
  -d $locale[es][name]="Producto de prueba" \
  -d $locale[es][tags]="etiqueta1, etiqueta2" \
  -X PUT
```

**Node**

```javascript
const { swell } = require('swell-node');
swell.init('store-id', 'secret-key');

await swell.put('/products/5cad15bc9b14d1990724663a', {
  name: 'Test product',
  tags: ['tag1', 'tag2'],
  $locale: {
    fr: {
      name: 'Test produit',
      tags: ['étiqueter1', 'étiqueter2']
    },
    es: {
      name: 'Producto de prueba',
      tags: ['etiqueta1', 'etiqueta2']
    },
  },
});
```

**PHP**

```php
<?php $swell = new \\Swell\\Client('store-id', 'secret-key');

$swell->put('/products/5cad15bc9b14d1990724663a', [
  'name' => 'Test product',
  'tags' => ['tag1', 'tag2'],
  '$locale' => [
    'fr' => [
      'name' => 'Test produit',
      'tags' => ['étiqueter1', 'étiqueter2']
    ],
    'es' => [
      'name' => 'Producto de prueba',
      'tags' => ['etiqueta1', 'etiqueta2']
    ],
  ],
]);
```

## Example response

```json
{
  "id": "5cad15bc9b14d1990724663a",
  "name": "Test product",
  "tags": ["tag1", "tag2"],
  "$locale": {
    "en": {
      "name": "Test product",
      "tags": ["tag1", "tag2"]
    },
    "fr": {
      "name": "Test produit",
      "tags": ["étiqueter1", "étiqueter2"]
    },
    "es": {
      "name": "Producto de prueba",
      "tags": ["etiqueta1", "etiqueta2"]
    }
  }
  ...
}
```