# Aliases

The **Aliases** object holds a collection of all the defined [folder aliases](../../../basic_concepts/the_lister/navigation/aliases). It is retrieved from the [**DOpus**](dopus)**.aliases** method.

| Property Name      | Return Type                     | Description                                                                                                                                       |
| ------------------ | ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| _\<default value>_ | _collection:_[**Alias**](alias) | You can enumerate the **Aliases** object, or query the value of an individual alias by name (e.g. _DOpus.Output(DOpus.aliases("desktop").path);_) |

| Method Name | **Arguments**                                   | Return Type | Description                                                                                                                                                                                                                                                                                                                                                         |
| ----------- | ----------------------------------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Add         | <p>&#x3C;string:name><br>&#x3C;string:path></p> | _none_      | Adds a new alias to the system with the specified name and path. Note that you should **not** provide the leading forward-slash (/) in the alias name.                                                                                                                                                                                                              |
| Delete      | \<string:name>                                  | _none_      | Deletes the specified alias.                                                                                                                                                                                                                                                                                                                                        |
| Update      | _none_                                          | _none_      | Updates the state of this object. When the **Aliases** object is first retrieved via **DOpus.aliases**, a snapshot is taken of the aliases at that time. If you make changes via the object it will reflect them but any changes made outside the script (e.g. via the **Favorites ADD=alias** command) will not be detected unless you call the **Update** method. |
