# xarray.DataArray.swap_dims

#### DataArray.swap_dims(dims_dict=None, \*\*dims_kwargs)[[source]](https://github.com/pydata/xarray/blob/main/xarray/core/dataarray.py#L2728-L2785)

Return a new DataArray with swapped dimensions.

* **Parameters:**
  * **dims_dict** ([dict-like](https://docs.python.org/3/glossary.html#term-mapping)) – Dictionary whose keys are current dimension names and whose values
    are new names.
  * **\*\*dims_kwargs** (`{existing_dim: new_dim, ...}`, *optional*) – The keyword arguments form of `dims_dict`.
    One of dims_dict or dims_kwargs must be provided.
* **Returns:**
  **swapped** ([`DataArray`](xarray.DataArray.html.md#xarray.DataArray)) – DataArray with swapped dimensions.

#### SEE ALSO
[`DataArray.rename`](xarray.DataArray.rename.html.md#xarray.DataArray.rename), [`Dataset.swap_dims`](xarray.Dataset.swap_dims.html.md#xarray.Dataset.swap_dims)

### Examples

<div class="try_examples_button_container"><button class="try_examples_button" onclick="window.tryExamplesShowIframe('afada0f7-e551-4ead-a94a-589880b4f6fd','333daf7f-2dfa-4c0b-a080-146d37921db7','41f77e46-c7fc-481f-85ae-558644812b6b','../lite/tree/../notebooks/index.html?path=5b3f4533_685e_4444_a52d_7dc10e244a89.ipynb','None')">Try it in your browser!</button></div>
```pycon
>>> arr = xr.DataArray(
...     data=[0, 1],
...     dims="x",
...     coords={"x": ["a", "b"], "y": ("x", [0, 1])},
... )
>>> arr
<xarray.DataArray (x: 2)> Size: 16B
array([0, 1])
Coordinates:
  * x        (x) <U1 8B 'a' 'b'
    y        (x) int64 16B 0 1
```

```pycon
>>> arr.swap_dims({"x": "y"})
<xarray.DataArray (y: 2)> Size: 16B
array([0, 1])
Coordinates:
  * y        (y) int64 16B 0 1
    x        (y) <U1 8B 'a' 'b'
```

```pycon
>>> arr.swap_dims({"x": "z"})
<xarray.DataArray (z: 2)> Size: 16B
array([0, 1])
Coordinates:
    x        (z) <U1 8B 'a' 'b'
    y        (z) int64 16B 0 1
Dimensions without coordinates: z
```

<div id="41f77e46-c7fc-481f-85ae-558644812b6b" class="try_examples_outer_iframe  hidden"><div class="try_examples_button_container"><button class="try_examples_button" onclick="window.tryExamplesHideIframe('afada0f7-e551-4ead-a94a-589880b4f6fd','41f77e46-c7fc-481f-85ae-558644812b6b')">Go Back</button><button class="try_examples_button" onclick="window.openInNewTab('afada0f7-e551-4ead-a94a-589880b4f6fd','41f77e46-c7fc-481f-85ae-558644812b6b')">Open In Tab</button></div><div id="333daf7f-2dfa-4c0b-a080-146d37921db7" class="jupyterlite_sphinx_iframe_container"></div></div><script>document.addEventListener("DOMContentLoaded", function() {window.loadTryExamplesConfig("../try_examples.json");});</script>