# xarray.Dataset.assign_attrs

#### Dataset.assign_attrs(\*args, \*\*kwargs)[[source]](https://github.com/pydata/xarray/blob/main/xarray/core/common.py#L674-L727)

Assign new attrs to this object.

Returns a new object equivalent to `self.attrs.update(*args, **kwargs)`.

* **Parameters:**
  * **\*args** – positional arguments passed into `attrs.update`.
  * **\*\*kwargs** – keyword arguments passed into `attrs.update`.

### Examples

<div class="try_examples_button_container"><button class="try_examples_button" onclick="window.tryExamplesShowIframe('2aa1c1c9-d178-46fd-ac5e-e0ce05f6e0c5','e0028efa-85bf-4026-a5c5-25b32f6ade8b','8cb35e23-6ba3-4e0d-b003-4906710d3a42','../lite/tree/../notebooks/index.html?path=aa2cb9d8_81dd_48a4_b13e_e5e96538c7b8.ipynb','None')">Try it in your browser!</button></div>
```pycon
>>> dataset = xr.Dataset({"temperature": [25, 30, 27]})
>>> dataset
<xarray.Dataset> Size: 24B
Dimensions:      (temperature: 3)
Coordinates:
  * temperature  (temperature) int64 24B 25 30 27
Data variables:
    *empty*
```

```pycon
>>> new_dataset = dataset.assign_attrs(
...     units="Celsius", description="Temperature data"
... )
>>> new_dataset
<xarray.Dataset> Size: 24B
Dimensions:      (temperature: 3)
Coordinates:
  * temperature  (temperature) int64 24B 25 30 27
Data variables:
    *empty*
Attributes:
    units:        Celsius
    description:  Temperature data
```

# Attributes of the new dataset

```pycon
>>> new_dataset.attrs
{'units': 'Celsius', 'description': 'Temperature data'}
```

<div id="8cb35e23-6ba3-4e0d-b003-4906710d3a42" class="try_examples_outer_iframe  hidden"><div class="try_examples_button_container"><button class="try_examples_button" onclick="window.tryExamplesHideIframe('2aa1c1c9-d178-46fd-ac5e-e0ce05f6e0c5','8cb35e23-6ba3-4e0d-b003-4906710d3a42')">Go Back</button><button class="try_examples_button" onclick="window.openInNewTab('2aa1c1c9-d178-46fd-ac5e-e0ce05f6e0c5','8cb35e23-6ba3-4e0d-b003-4906710d3a42')">Open In Tab</button></div><div id="e0028efa-85bf-4026-a5c5-25b32f6ade8b" class="jupyterlite_sphinx_iframe_container"></div></div><script>document.addEventListener("DOMContentLoaded", function() {window.loadTryExamplesConfig("../try_examples.json");});</script>
* **Returns:**
  **assigned** (`same type as caller`) – A new object with the new attrs in addition to the existing data.

#### SEE ALSO
[`Dataset.assign`](xarray.Dataset.assign.html.md#xarray.Dataset.assign)