# Add Listing

It is recommended to create a special page where private sellers and dealers can publish their listings. 

1. [Enabling the "Add a Car" Button on the header.](#enabling-the-add-a-car-button-on-the-header)
2. [How to build a "Listing Submission" page with Elementor.](#how-to-build-a-listing-submission-page-with-elementor)
3. [How to build a "Listing Submission" page with WPBakery.](#how-to-build-a-listing-submission-page-with-wpbakery)

## Enabling the "Add a Car" Button on the header

In Classified layouts, the **"Add a Car"** button can be displayed in the header navigation. To do this go to the **WP Dashboard > Theme Options > Header > Buttons/Actions** and enable "Show Add a Car Button":

<figure><img src="/files/7CaksonYCVk6A7zueusl" alt=""><figcaption></figcaption></figure>

Customize the label, change colors, and set a link for the page with the Add a Car form.

<figure><img src="/files/I5maxZiTsQvmymu6Xt5A" alt=""><figcaption></figcaption></figure>

To make the button work, the page should contain **"Add Listing"** or **"STM Add a car"** widgets based on the page builder.

## How to build a "Listing Submission" page with Elementor

The page where users submit listings comes with demo import and it has the following view by default:

<figure><img src="/files/UAFaIthphRWXyPuEj1dg" alt=""><figcaption></figcaption></figure>

By editing the page it is possible to apply the default Advanced settings of Elementor:

<figure><img src="/files/62dN6meWovT0llpKTqih" alt=""><figcaption></figcaption></figure>

The Content of the form is managed from the Motors Plugin directly. Refer to this manual to get more info:

{% content-ref url="/pages/hLjc0TQlWfXWOWJ4l1r2" %}
[Add Listing Form](/motors-theme-documentation/single-listing/add-listing-form.md)
{% endcontent-ref %}

## How to build a "Listing Submission" page with WPBakery

{% embed url="<https://youtu.be/aSY87n5S_vc?si=mSpjMVOZH6a0VoSR>" %}

The page where users submit listings comes with demo import and it has the following view by default:

<figure><img src="/files/UAFaIthphRWXyPuEj1dg" alt=""><figcaption></figcaption></figure>

It is possible to adjust settings and add custom content by editing the page.

<figure><img src="/files/HFD5EA48fSjbFgNfoJPE" alt=""><figcaption></figcaption></figure>

The **STM Posts Available** widget - shows the number of slots available for the user to upload their listings.

The **STM Add a Car** widget generates a form for adding listing details with the following customizable settings:

### Step 1. General:

{% tabs %}
{% tab title="Widget Settings" %}

<figure><img src="/files/Lx0HZo5s9RALeDThLJLc" alt=""><figcaption></figcaption></figure>

* **Include car title** - When the option is enabled, Users/Dealers can set a custom title for the listing.&#x20;
* **Main taxonomies to fill** - select which categories are compulsory to select before submitting the listing.
* **Show number fields as input instead of dropdown** - when the option is enabled users can type numbers on themselves. Otherwise, the system displays a drop-down with numbers to select.
* **Allowed histories** - Car history providers that dealers can use.
  {% endtab %}

{% tab title="How the page appears" %}

<figure><img src="/files/DjtSYUx5GhuUyuC4wB1z" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
In the Screenshot above the required fields are marked with "**\***".
{% endhint %}
{% endtab %}
{% endtabs %}

### Step 2. Features:

In this section, users and dealers can select additional features for the car they are publishing.

{% tabs %}
{% tab title="Widget Settings" %}

<figure><img src="/files/zusVRR1au3nC7bObjoAj" alt=""><figcaption></figcaption></figure>

Site administrators can group the listing features by assigning a title to the group in the settings. Please type the car features separated by commas without any additional spaces.
{% endtab %}

{% tab title="How the page appears" %}

<figure><img src="/files/X6FkK5ttE4lsflzURuGw" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

### Step 3. Gallery

The listing images will be uploaded in the Gallery section.

{% tabs %}
{% tab title="Widget Settings" %}

<figure><img src="/files/waGq0VwN1KCMwQFdubux" alt=""><figcaption></figcaption></figure>

Site administrators can provide guidelines on how to upload images, including recommended resolution and size.
{% endtab %}

{% tab title="How the page appears" %}

<figure><img src="/files/g7THFY42ktW2srJbNoko" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

### Step 4. Videos

Users can upload multiple videos from hosting services like **YouTube** and **Vimeo**.

<figure><img src="/files/1dTHs25yrTwqpv9qYvK2" alt=""><figcaption></figcaption></figure>

### Step 5. Phrases

In this section, users and dealers can provide a short description of their listing.

{% tabs %}
{% tab title="Widget Settings" %}

<figure><img src="/files/j6pmGxLOmkRJ3CK32alK" alt=""><figcaption></figcaption></figure>

In the settings, it is possible to define template phrases by separating them with commas.
{% endtab %}

{% tab title="How the page appears" %}
Default view:

<figure><img src="/files/9K7aRutDS8OlsBeWdLmV" alt=""><figcaption></figcaption></figure>

When the "**Add Template Phrases**" button is clicked, it is possible to select several pre-written sentences to use as a car description:

<figure><img src="/files/vmTUbdo4nXwrKto8IA6l" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

### Step 6.  Price

You can set the price for uploading a listing in this section.

{% tabs %}
{% tab title="Widget Settings" %}

<figure><img src="/files/kBOBp7YD2DzGr6TfunMy" alt=""><figcaption></figcaption></figure>

**Price label** - The label from settings appears behind the price.

**Show Sale Price label** - When Enabled, users/dealers can set the sale price while uploading the listing.&#x20;

**Sale Price label** - Custom label for the sale price.

**Show Custom label** - When enabled, the price is hidden and a custom label appears. Customers must request the car price through a form.
{% endtab %}

{% tab title="How the page appears" %}
Default view:

<figure><img src="/files/xPzJdc1hrTaoaAm9OM9b" alt=""><figcaption></figcaption></figure>

When the **Sale price** and **Custom labels** are enabled:

<figure><img src="/files/PKYmhM3RIlHVDQGnSZq8" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

### Register/Login user

When a guest user tries to upload a listing, they will be offered the option to create a new account or log into an existing one.

{% tabs %}
{% tab title="Widget Settings" %}

<figure><img src="/files/iygQ80I4ERMp4eobnlNo" alt=""><figcaption></figcaption></figure>

Administrators of the site have the ability to notify users who are in the process of creating their accounts.
{% endtab %}

{% tab title="How the page appears" %}

<figure><img src="/files/Q9uudHVLtstR8L404VcF" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

{% hint style="info" %}
The layout of all published listings will be displayed according to a single listing template.
{% endhint %}

{% content-ref url="/pages/-MERuF7Fe0VDOfWYLIn3" %}
[Listing Templates](/motors-theme-documentation/single-listing/listing-templates.md)
{% endcontent-ref %}


---

# 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-theme-documentation/classified-layout-features/add-listing.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.