> For the complete documentation index, see [llms.txt](https://docs.stylemixthemes.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.stylemixthemes.com/motors-theme-documentation/~/changes/70wBWN8w43jv4AA52cti/classified-layout-features/add-listing.md).
# 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)
* [Add Listing general setting.](#add-listing-general-setting)
* [Add Listing Layout Manager.](#add-listing-layout-manager)
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 **Dashboard > Theme Options > Header > Buttons/Actions** and enable "Show Add a Car Button":
Customize the label, change colors, and set a link for the page with the Add a car form.
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:
By editing the page it is possible to apply the default Advanced settings of Elementor:
The Content of the page is managed from theme options directly.
### **Add Listing general setting**
In Elementor demos, by opening **Dashboard > Theme options > Add Listing > General** section, the layout of the Add Listing page can be managed by dividing it into sections.
#### Description & Slots
{% tabs %}
{% tab title="Settings in Theme options" %}
{% hint style="success" %}
The number of available slots can be disabled when it is not necessary to show.
{% endhint %}
{% endtab %}
{% tab title="How the page appears" %}
Default view:
When the number of available slots are disabled:
{% endtab %}
{% endtabs %}
#### Title
{% tabs %}
{% tab title="Settings in Theme options" %}
When the option is enabled, Users/Dealers can set a custom title for the listing.
{% endtab %}
{% tab title="How the page appears" %}
Default view:
When the "Title" disabled:
{% endtab %}
{% endtabs %}
{% hint style="info" %}
By default, the listing title will be generated using listing categories by the system:
{condition} {ca-year} {make} {serie}
{% endhint %}
To display the custom title of the users to the cars, go to **Theme options > Inventory settings > Grid/List Card** then edit “Display Generated Car Title as” need to leave the input empty.
#### Details
In this section users/dealers provide details about the vehicle by selecting to which category it belongs.
{% tabs %}
{% tab title="Settings in Theme options" %}
**Required Categories** - Select which categories are compulsory to select before submitting the listing.
**Transform numeric categories to input fields** - When the option is enabled users can type numbers on themselves. Otherwise, the system displays a drop-down with numbers to select.
**Registered Date** - When enabled, the field with Datepicker will be added to the Add Car page.
**VIN** - The input field to type the vehicle's VIN number will be added. Using this number buyers can check car history.
**History** - Allows users to provide external reports for the vehicle through the link.
**Allowed Histories** - Car history providers that dealers can use.
**Location** - Option to set coordinates to show where the car can be located.
{% endtab %}
{% tab title="How the page appears" %}
{% hint style="info" %}
In the Screenshot above the required fields are marked with "**\***" and optional fields that can be disabled are outlined with a red border.
{% endhint %}
{% endtab %}
{% endtabs %}
#### Features
In this section, users and dealers can select additional features for the car they are publishing.
{% tabs %}
{% tab title="Settings in Theme options" %}
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" %}
{% endtab %}
{% endtabs %}
#### Gallery
The listing images will be uploaded in the Gallery section.
{% tabs %}
{% tab title="Settings in Theme options" %}
Site administrators can provide guidelines on how to upload images, including recommended resolution and size.
{% endtab %}
{% tab title="How the page appears" %}
{% endtab %}
{% endtabs %}
#### Videos
This section allows for the inclusion of a video listing through external links.
{% tabs %}
{% tab title="Settings in Theme options" %}
{% endtab %}
{% tab title="How the page appears" %}
Users can upload multiple videos from hosting services like **YouTube** and **Vimeo**.
{% endtab %}
{% endtabs %}
#### Seller Note
In this section, users and dealers can provide a short description of their listing.
{% tabs %}
{% tab title="Settings in Theme options" %}
In the settings, it is possible to define template phrases by separating them with commas.
{% endtab %}
{% tab title="How the page appears" %}
Default view:
When the "**Add Template Phrases**" button is clicked, it is possible to select several pre-written sentences to use as a car description.
{% endtab %}
{% endtabs %}
#### Subscription Plans & Price
You can set the price for uploading a listing in this section.
{% tabs %}
{% tab title="Settings in Theme options" %}
**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.
**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:
With pricing pan:
When the **Sale price** and **Custom labels** are enabled:
{% endtab %}
{% endtabs %}
#### Register/Login
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="Settings in Theme options" %}
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" %}
{% endtab %}
{% endtabs %}
### **Add Listing Layout manager**
Elementor demo layouts have the option to rearrange or disable certain sections from the "Add Listing" page. To do this, **Dashboard > Theme options > Add Listing > Layout Manager** and move fields to the "Disable Layouts" column:
{% hint style="danger" %}
The sections for **Details** and **Price** are mandatory and cannot be disabled.
{% endhint %}
## How to build a "Listing Submission" page with WPBakery
The page where users submit listings comes with demo import and it has the following view by default:
It is possible to adjust settings and add custom content by editing the page.
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" %}
* **Include car title** - When the option is enabled, Users/Dealers can set a custom title for the listing.
* **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" %}
{% 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" %}
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" %}
{% endtab %}
{% endtabs %}
### Step 3. Gallery
The listing images will be uploaded in the Gallery section.
{% tabs %}
{% tab title="Widget Settings" %}
Site administrators can provide guidelines on how to upload images, including recommended resolution and size.
{% endtab %}
{% tab title="How the page appears" %}
{% endtab %}
{% endtabs %}
### Step 4. Videos
Users can upload multiple videos from hosting services like **YouTube** and **Vimeo**.
### Step 5. Phrases
In this section, users and dealers can provide a short description of their listing.
{% tabs %}
{% tab title="Widget Settings" %}
In the settings, it is possible to define template phrases by separating them with commas.
{% endtab %}
{% tab title="How the page appears" %}
Default view:
When the "**Add Template Phrases**" button is clicked, it is possible to select several pre-written sentences to use as a car description:
{% endtab %}
{% endtabs %}
### Step 6. Price
You can set the price for uploading a listing in this section.
{% tabs %}
{% tab title="Widget Settings" %}
**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.
**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:
When the **Sale price** and **Custom labels** are enabled:
{% 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" %}
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" %}
{% endtab %}
{% endtabs %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## 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, and the optional `goal` query parameter:
```
GET https://docs.stylemixthemes.com/motors-theme-documentation/~/changes/70wBWN8w43jv4AA52cti/classified-layout-features/add-listing.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.
