# Audio

## New Hub Listing

### Create

Audio listings allow users to **upload and share audio files**.

To start the creation process:

* Go to the **MY LISTINGS** page.
* Click on the **AUDIO** icon to begin.

<figure><img src="https://540871446-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVJV84grXWXSLppsAzVKx%2Fuploads%2Fdmr9uY70GK32BEi0bRKn%2Fimage.png?alt=media&#x26;token=81327bf2-f445-444c-9907-5214add7b461" alt=""><figcaption></figcaption></figure>

<figure><img src="https://540871446-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVJV84grXWXSLppsAzVKx%2Fuploads%2FUX60qWYpDDVvanq6tQWc%2Fimage.png?alt=media&#x26;token=d8ab0ac4-36cb-4668-bbd4-11dc4d036a5c" alt="" width="563"><figcaption></figcaption></figure>

### Listing Type Modal

After clicking the **AUDIO** icon, the **LISTING TYPE** modal will appear.\
In this modal, you can choose from the following options:

* **New Hub Listing**
* **New Version** of an existing listing
* **Remix** of another user's listing

<figure><img src="https://540871446-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVJV84grXWXSLppsAzVKx%2Fuploads%2FbsVDY5cowfjA4D0YIKv4%2Fimage.png?alt=media&#x26;token=3d9da0d0-557d-4a21-83e3-3968ceecb85f" alt=""><figcaption></figcaption></figure>

To create a new listing, select **NEW HUB LISTING** and click **NEXT** to proceed.

{% hint style="info" %}
This guide focuses on creating a **New Hub Listing**. For details on creating a **New Version** or a **Remix**, check the additional resources linked below.\
[New Version](https://docs.motar.com/how-to/motar-core-services/using-motar-studio/about-motar-digital-thread/new-version-or-digital-thread) or [Remix](https://docs.motar.com/how-to/motar-core-services/using-motar-studio/about-motar-digital-thread/remix-or-digital-thread).
{% endhint %}

### Upload

After selecting the **New Hub Listing** option, you will be directed to the **UPLOAD** tab.\
Here, you are required to **upload a supported audio file**.

<figure><img src="https://540871446-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVJV84grXWXSLppsAzVKx%2Fuploads%2Fkw1VpgHoaumZmdDX2Zqs%2Fimage.png?alt=media&#x26;token=6d25c823-72e0-4e71-801a-8b0d29061593" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
The **File Upload and Scanning Tool** will launch to help with this process (see the link below for detailed instructions).
{% endhint %}

{% content-ref url="../motar-secure-file-upload-and-scanning" %}
[motar-secure-file-upload-and-scanning](https://docs.motar.com/how-to/motar-core-services/using-motar-studio/motar-secure-file-upload-and-scanning)
{% endcontent-ref %}

Once the scan is completed successfully, you can close the modal, and the audio file will be listed.

### Info

After the file is uploaded, the **INFO** tab will allow you to complete the following:

* The **Listing Name** will auto-populate to match the name of the file that was uploaded. *You can **edit** this name at this point to your preferred listing name.*
* **Listing Description**: Provide a brief description of the listing.

<figure><img src="https://540871446-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVJV84grXWXSLppsAzVKx%2Fuploads%2FvGu4167kxG6obUssmPcM%2Fimage.png?alt=media&#x26;token=b312e397-77ef-4d06-8558-f39552c9f2c4" alt=""><figcaption></figcaption></figure>

You can **save your progress** after uploading the file, naming the listing, and filling in the description.\
This allows you to come back and complete any remaining fields later.

{% hint style="warning" %}
&#x20;A listing cannot be promoted from Sandbox to Production until all required fields have been completed.
{% endhint %}

### Permissions

To set permissions for your listing:

* Navigate to the **PERMISSIONS** tab.
* Click the **LAUNCH** button to run the **Permissions Wizard**.

<figure><img src="https://540871446-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVJV84grXWXSLppsAzVKx%2Fuploads%2FoZU53zMTGAWckd41v2tA%2Fimage.png?alt=media&#x26;token=1d6de268-e9ff-4b5d-aeb1-cfd57d61816f" alt=""><figcaption></figcaption></figure>

<figure><img src="https://540871446-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVJV84grXWXSLppsAzVKx%2Fuploads%2FoTr9YdwsFAl2mt32M2B8%2Fimage.png?alt=media&#x26;token=26ba2d62-34f6-48fe-9be8-acd349797262" alt="" width="563"><figcaption></figcaption></figure>

Full instructions on how to use the wizard can be found below:

{% content-ref url="../how-to-manage-listing-permissions" %}
[how-to-manage-listing-permissions](https://docs.motar.com/how-to/motar-core-services/using-motar-studio/how-to-manage-listing-permissions)
{% endcontent-ref %}

Once you've configured the permissions:

* **Click the SAVE** button to apply all requested changes.
* This will enable the option to adjust the **Hub Visibility** for your listing.

{% hint style="info" %}
After saving permissions, you’ll see the **Hub Visibility** toggle in the **top right corner** of the listing’s edit page.

* **Sandbox Listings:** Hub visibility is **OFF** by default (not publicly visible).
* **Production Listings:** Hub visibility is **ON** by default (publicly visible).
  {% endhint %}

### Digital Thread

* The **current version** of the listing
* Any future **versions** or **remixes** created from it

The **DIGITAL THREAD** tab provides a centralized view of a listing’s **entire digital lifecycle**.\
It captures and displays:

When creating a **new listing**, this tab will initially show **only that listing**.\
As you or others create new versions or remixes, those will be added to this view automatically.

You can return to the **Digital Thread** tab at any time by choosing to **EDIT** the listing from the **MY LISTINGS** page.

{% hint style="info" %}
From the Digital Thread tab, users can **set a listing as Authoritative or Certified**—but only **after it has been promoted to Production**.

For more guidance on how to authorize or certify a listing, click [here](https://docs.motar.com/how-to/motar-core-services/using-motar-studio/about-motar-digital-thread/authorizing-and-certifying-listings).
{% endhint %}

<figure><img src="https://540871446-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVJV84grXWXSLppsAzVKx%2Fuploads%2FVOg9IJavgUYh8rjUKDyd%2Fimage.png?alt=media&#x26;token=57b1d990-38ce-47ff-a38f-9ad12c71d9ac" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
See the following links for more information on [Digital Thread](https://docs.motar.com/how-to/motar-core-services/using-motar-studio/about-motar-digital-thread/digital-thread-iconology) and the [Digital Thread Iconology](https://docs.motar.com/how-to/motar-core-services/using-motar-studio/about-motar-digital-thread/digital-thread-iconology).
{% endhint %}

{% hint style="warning" %}
All listings remain in **Sandbox** until they are **promoted and approved for Production**. This means their authoritative or certified status cannot be applied until that transition happens.
{% endhint %}

### Publish

Once all **required information** for a listing is complete and the listing has been **saved**, the **PUBLISH** button becomes available.

Publishing a listing moves it from **Sandbox** to **Production**, making it officially available for wider access.

{% hint style="danger" %}
After publishing, users will **no longer be able to change files** on the **UPLOAD** tab.\
However, you **can still update**:

* Description on the **INFO** tab
* Listing **permissions**
  {% endhint %}

To publish:

* **Click** the **PUBLISH** button.

<figure><img src="https://540871446-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVJV84grXWXSLppsAzVKx%2Fuploads%2FiO7vLVsHpkZbHxP98K9B%2Fimage.png?alt=media&#x26;token=51f9eddc-78f0-4ddc-948a-c942e6dfe06c" alt=""><figcaption></figcaption></figure>

* The **Permissions for Production** modal will open.
* Choose between:
  * **KEEP CURRENT** permissions
  * **SET NEW** permissions
* For this example, select **KEEP CURRENT** and then click **NEXT**.

<figure><img src="https://540871446-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVJV84grXWXSLppsAzVKx%2Fuploads%2FQdErLHftZr40hRv6PVaB%2Fimage.png?alt=media&#x26;token=31bf591f-b735-4ca2-b509-999b11af80fd" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Choosing **SET NEW** permissions will **overwrite the existing permissions** for the listing.

Need help setting new permissions?

Full instructions on how to run the Permissions Wizard can be found at the link below.
{% endhint %}

{% content-ref url="../how-to-manage-listing-permissions" %}
[how-to-manage-listing-permissions](https://docs.motar.com/how-to/motar-core-services/using-motar-studio/how-to-manage-listing-permissions)
{% endcontent-ref %}

The modal will close and the listing will be updated from Sandbox to Production.

<figure><img src="https://540871446-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVJV84grXWXSLppsAzVKx%2Fuploads%2FYDIx0F1i2QEz9DhDNvf3%2Fimage.png?alt=media&#x26;token=cff3e0d4-8889-47c9-9e0b-c0cb6302bf6a" alt=""><figcaption></figcaption></figure>

***

## Edit

To edit an existing listing:

* Go to the **MOTAR Studio – MY LISTINGS** page.
* Click the **PENCIL** icon in the **ACTION** column of the listing you want to edit.

<figure><img src="https://540871446-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVJV84grXWXSLppsAzVKx%2Fuploads%2FV9JmJCbxojrpgTPGvZ1q%2Fimage.png?alt=media&#x26;token=5bd5534a-bfee-42e1-8fc3-449b4928e919" alt=""><figcaption></figcaption></figure>

You can make changes in the following tabs:

* **UPLOAD**
* **INFO**
* **PERMISSIONS**
* **DIGITAL THREAD**

Navigate between tabs by either:

* Clicking the **TAB TITLE**
* Clicking the **NEXT** button to move through the sections

{% hint style="info" %}
If you need to **update permissions**:

1. Go to the **PERMISSIONS** tab.
2. Click the **MODIFY** button to launch the **Permissions Wizard**.

Full instructions on using the wizard can be found below.
{% endhint %}

{% content-ref url="../how-to-manage-listing-permissions" %}
[how-to-manage-listing-permissions](https://docs.motar.com/how-to/motar-core-services/using-motar-studio/how-to-manage-listing-permissions)
{% endcontent-ref %}

After making your desired edits:

* **Click the SAVE** button to apply all changes and update the listing.

***

## Delete

To delete a listing:

* Go to the **MY LISTINGS** page in MOTAR Studio.
* Click the **PENCIL** icon in the **ACTION** column for the listing you want to delete.
* Navigate to the **DIGITAL THREAD** tab.
* Click the **TRASH CAN** icon in the **ACTION** column.

<figure><img src="https://540871446-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVJV84grXWXSLppsAzVKx%2Fuploads%2FNleTOSbiceKZX27P3XiS%2Fimage.png?alt=media&#x26;token=dd9e054b-19bd-472b-9b79-9edf8a824540" alt=""><figcaption></figcaption></figure>

A **Delete Listing** modal will appear.

To confirm:

* **Type** the word `DELETE` in the text field.
* This will **activate** the **DELETE** button.
* Click the **DELETE** button to confirm the deletion.

<figure><img src="https://540871446-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVJV84grXWXSLppsAzVKx%2Fuploads%2FCSJFcuueNu6EsZ6JrGjx%2Fimage.png?alt=media&#x26;token=5b64881c-6d1c-4fa5-815a-3bcec5116248" alt=""><figcaption></figcaption></figure>

Once deleted:

* You’ll be returned to the **DIGITAL THREAD** tab.
* The listing will now display as **archived** in:
  * The **DIGITAL THREAD** tab
  * The **MY LISTINGS** page

<figure><img src="https://540871446-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVJV84grXWXSLppsAzVKx%2Fuploads%2FXsaDQzWShNFiGB35YaHG%2Fimage.png?alt=media&#x26;token=a030bbcc-133c-43aa-b544-b7f6d2b37b84" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Mobile Users: Control volume while viewing an Audio listing using the physical buttons on the device.&#x20;
{% endhint %}