# Listing Actions

{% embed url="<https://youtu.be/gIZS5HMQOVU?t=1627&si=xEY9BtkbsWt-592m>" %}

Listings are custom post types used to showcase cars that company owners publish as advertisements. Site administrators can access all listings in the **WP Dashboard > Motors Plugin> Listings** section:

<figure><img src="/files/O8fCIhdAcfGjiUv2HT3T" alt=""><figcaption><p><strong>WP Dashboard > Motors Plugin> Listings</strong> </p></figcaption></figure>

For each listing, you can specify a **description**, standard **Single Car Page Options,** and customizable **Car Options** with Listing Manager while editing them individually.&#x20;

{% content-ref url="/pages/3rqMjGgHjAbhTi0clRDc" %}
[Listing Manager](/motors-car-dealer-classifieds-and-listing/listing-management/listing-manager.md)
{% endcontent-ref %}

### How to Add a New Listing? (admin)

Creating a new listing is a straightforward action. You can follow **WP Dashboard > Listings > Add New** to add a new listing:

<figure><img src="/files/vftGkOK3LMvTEn8ZQksk" alt=""><figcaption><p>Add new listing</p></figcaption></figure>

{% hint style="info" %}
After that, you can continue to configure **listing** [**preferences**](/motors-car-dealer-classifieds-and-listing/listing-management/listing-actions/listing-preferences.md) and [**characteristics**](/motors-car-dealer-classifieds-and-listing/listing-management/listing-manager.md)**.**
{% endhint %}

### How to Add a New Listing? (user)

Users can add vehicles to your website via the special [**Listing Creation**](/motors-car-dealer-classifieds-and-listing/motors-plugin-settings/pages.md#listing-creation-page) page. You can add the link to this page anywhere according to your needs. For instance, you can place it in the navbar of your website.

<figure><img src="/files/uAkMq33LVXyVhpqv9yfb" alt=""><figcaption><p>Listing Creation Page as a button in the navbar of<a href="/pages/mfZ8GzUzvMy1L6Yen99a"> Motor Starter Theme</a></p></figcaption></figure>

{% hint style="info" %}
Refer to [**this page**](/motors-car-dealer-classifieds-and-listing/single-listing/add-listing-form/listing-creation-form.md) to learn more about the listing creation form.
{% endhint %}

### How to Remove a Listing?

Usually, listings will be moved to the trash, where they can later be restored.&#x20;

<figure><img src="/files/4ga3drwdKv0xshtfFOhh" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Listings moved to the **Trash** will no longer be displayed on your website. You can manually select listings in the Trash to **permanently delete** them, or you can use the **Empty Trash** button to **delete all items at once.**

Please note, there is no time limit for how long items can remain in the **Trash**. If you do not delete them permanently, listings will be stored in the Trash indefinitely.
{% endhint %}

You can use the bulk action '**Move to Trash**' or the **'Trash**' button to remove the listing(s) from your site:

<figure><img src="/files/c3a1LYlMakNdlU2QDArv" alt=""><figcaption><p>Moving listing(s) to trash</p></figcaption></figure>

### How to Change the Status (to hide) a Listing?

The listing status can be changed by following **WP Dashboard > Listings > Quick Edit:**

<figure><img src="/files/YQ95CvpwDRnyUBg0H1HQ" alt=""><figcaption><p>Quick Editing a listing</p></figcaption></figure>

In the status section, you can change the status to one of **Published, Pending Review,** or **Draft**. After selecting the appropriate status, click on the update button:

<figure><img src="/files/i0cnkM8Q2Iwi7gtkj7h4" alt=""><figcaption><p>Changing the Status of the Listing</p></figcaption></figure>

{% hint style="info" %}
In the Pending Review and Draft statuses, the listing will not be visible on your site.
{% endhint %}

Users can hide their listing in the My Inventory section of the [Users Page](/motors-car-dealer-classifieds-and-listing/motors-plugin-settings/pages.md#login-registration-page):

<figure><img src="/files/wxHB9QXk9hJKpr4xLQ4Q" alt=""><figcaption><p>Disabling the listings</p></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.stylemixthemes.com/motors-car-dealer-classifieds-and-listing/listing-management/listing-actions.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.