WPRentals Theme Documentation WPRentals Theme Documentation

  • Client Support
  • Video Tutorials
  • WPRentals
  • WPEstate
  • API
Home / Property / Listing / Videos – How to add a listing – User Dashboard & Submission Form

Videos – How to add a listing – User Dashboard & Submission Form

8541 views

This help explains how listings are added in WPRentals, how the front-end User Dashboard works, and which admin settings control the listing submission form.

Content

  • How listing submission works
  • Who can add listings
  • Create or check the User Dashboard pages
  • Manage the listing submission form fields
  • Set the booking options used in the submission form
  • Manage guest options
  • Manage categories and location fields
  • Manage custom fields and default listing fields
  • Property Description editor and formatting
  • Add a new listing from the front end
  • Can listings be added from wp-admin?
  • Related help

How Listing Submission Works

In WPRentals, listings are added and edited from the front-end User Dashboard.

The correct paths are:

User Dashboard → My Listings → Add New Listing

or:

User Dashboard → My Listings → Edit Listing

This is the recommended workflow because the front-end dashboard includes the rental-specific fields, such as price, images, location, booking type, calendar, availability, guest options, and owner-related settings.

Important: Even if you are the site admin and manage all listings yourself, the front-end User Dashboard is the recommended place to add and edit listings in WPRentals.
In this tutorial, you will learn how to add a new listing from the front end of your WPRentals website. Watch Video on Youtube

Who Can Add Listings

WPRentals supports two common listing management workflows:

1. Multiple owners / users submit listings

Use this setup when different owners register on the website and submit their own listings from the front-end User Dashboard.

In this case:

  • Owners register or log in.
  • Owners use the User Dashboard to add and edit their listings.
  • The admin controls which fields are available in the submission form.
  • The admin can approve listings manually or allow automatic approval, depending on the site setup.

Login and Register setup

2. Single site owner / admin manages all listings

Use this setup when the website belongs to one owner, agency, or company, and the admin manages all listings.

In this case:

  • The admin logs in.
  • The admin uses the front-end User Dashboard to add and edit listings.
  • The website does not need to allow public owner registration if all listings are managed by the site owner.
Recommended: For both workflows, use the front-end User Dashboard to add and edit listings. The User Dashboard is built for the WPRentals booking and availability workflow.

Create or Check the User Dashboard Pages

The User Dashboard pages are needed so owners or admins can manage listings from the front end.

If you imported demo content, these pages are usually already created. If you did not import demo content, you must create them manually.

The most important pages for adding and editing listings are:

  • Add New Listing page – created with the User Dashboard Submit – Step 1 page template.
  • Edit Listing page – created with the User Dashboard Edit page template.
  • My Listings page – used by owners or admins to see and manage their submitted listings.

To create a dashboard page:

  1. Go to Pages → Add New.
  2. Add the page title.
  3. Select the correct WPRentals dashboard page template.
  4. Publish the page.
This video explains how the site administrator can manage the user dashboard pages and the listing submission form fields. Watch Video on Youtube

How to create User Dashboard pages

Manage the Listing Submission Form Fields

The site admin controls which fields appear when an owner or admin adds a listing from the front-end dashboard.

Go to:

Theme Options → Add Listing Page & Payment Settings → Listing Submission Form

From this section, you can:

  • Choose which default listing fields show in the form
  • Choose which custom fields show in the form
  • Choose which Features and Amenities show in the form
  • Set which fields are mandatory
Important: If a field is disabled in the submission form settings, owners and admins will not see it when they add or edit a listing from the front end.

How to manage submit form fields and mandatory fields

Set the Booking Options Used in the Submission Form

Before listings are added, configure the global booking settings.

Go to:

Theme Options → Booking Configuration

From this area, you can manage important booking options such as:

  • Booking type: per day, per hour, or mixed booking
  • Weekend days
  • Long-stay price thresholds
  • Guest selector settings
  • Calendar settings
  • Booking form display options

These settings affect how the listing submission form and booking form behave.

This video explains how the site administrator manages booking-related details for the listing submission form. Watch Video on Youtube

Theme Options – Booking Settings

How to enable Instant Booking

Increase the number of months in the calendar

How to setup hourly booking

Manage Guest Options

Guest options control how guests are selected in the booking form and how guest fields appear in the listing submission form.

Go to:

Theme Options → Booking Configuration → Guest Selector Settings

From this section, you can manage options such as:

  • Use advanced guest control
  • Use a simple total guest dropdown
  • Show or hide the guest field in the submission form
  • Set the maximum guest number for dropdown selection
This video explains how guest numbers work in WPRentals and how to set the Total guest field. Watch Video on Youtube
This video explains how to manage guests as a dropdown in WPRentals booking forms. Watch Video on Youtube

Theme Options – Booking Settings

Manage Categories and Location Fields

Before listings are added, set how categories and location fields should work in the submission form.

Listings can use taxonomies such as:

  • Listing categories
  • Listing action categories
  • City
  • Area / neighborhood
  • Country, state, or county, depending on your setup
  • Features and amenities

For location fields, you can choose how users add the location:

  • Autocomplete location search
  • City and area dropdowns
  • Manual city and area input
Important: Choose the location method before owners start adding listings. Changing the location method later may require checking existing listing locations.
This video explains how to manage listing categories and set listing location options like autocomplete, dropdown, or manual input. Watch Video on Youtube

Location Options in Submit Listing Form

How to manage listing location with theme autocomplete

Manage Custom Fields and Default Listing Fields

WPRentals includes default listing fields, and you can also create custom listing fields when you need extra information.

Default fields can include fields such as price, images, listing details, guests, location, categories, features, and booking options.

Custom fields are managed from:

Theme Options → General → Listing Custom Fields

Use custom fields when you need extra listing information that is not included in the default WPRentals fields.

After creating a custom field, enable it in the listing submission form settings if owners must complete it when adding a listing.

This video explains how to manage default and custom listing fields in the WPRentals submission form. Watch Video on Youtube

Add, edit, and delete listing custom fields

Submit Listing Form: Price Details Explained

Property Description Editor and Formatting

In the WPRentals front-end Dashboard Submit / Edit Listing form, the Property Description field uses a plain textarea field.

This means the front-end dashboard form does not load the WordPress visual editor for this field. Formatting buttons, such as bold, headings, colors, or lists, are not available in the default dashboard form.

Important: If styled content or HTML is pasted into the Property Description field, the formatting can be cleaned when the listing is saved. This is required for security reasons when content is submitted from the front end.

There is no Theme Options setting that replaces the front-end Property Description textarea with the WordPress visual editor.

If you need users to keep formatted content in the front-end Dashboard description field, this requires custom development. A developer can override the submit template and replace the description textarea with a custom editor solution.

The template files usually involved are:

  • wp-content/themes/wprentals/templates/submit_templates/property_description.php
  • wp-content/themes/wprentals/templates/submit_templates/property_description_first.php, if your setup uses the description-first layout
Important: This is a custom code change and is outside the standard theme support service. Always make a full backup and test changes on a staging site first.

Add a New Listing From the Front End

After the dashboard pages and submission settings are ready, owners or admins can add a listing from the front end.

Go to:

User Dashboard → My Listings → Add New Listing

Then complete the listing form:

  1. Add the listing title and description.
  2. Add the listing price and price details.
  3. Add the listing category, type, city, area, and location.
  4. Add the map location, if required by your setup.
  5. Add images and media.
  6. Add listing details, custom fields, and features or amenities.
  7. Add booking settings, availability, and calendar details.
  8. Save or submit the listing.

To edit an existing listing, go to:

User Dashboard → My Listings → Edit Listing

Important: The exact fields shown in the form depend on what the admin enabled in Theme Options → Add Listing Page & Payment Settings → Listing Submission Form.

Can Listings Be Added From wp-admin?

Listings can be created from the WordPress admin, but the recommended WPRentals workflow is to add and edit listings from the front-end User Dashboard.

The front-end dashboard is designed for the WPRentals rental workflow and gives access to the listing details, pricing, booking, calendar, availability, and owner-related options.

This applies to both website models:

  • Multiple owner website: owners register, log in, and submit their own listings from the User Dashboard.
  • Single owner / site admin website: the admin logs in and uses the User Dashboard to add and manage all listings.
Recommended: Use User Dashboard → My Listings → Add New Listing and User Dashboard → My Listings → Edit Listing for listing management.

Related Help

User Dashboard and Submission Setup

  • How to create User Dashboard pages
  • Submit a Listing from the User Dashboard
  • How to manage submit form fields and mandatory fields
  • Adding Listings with Free Submission
  • Paid Submission
  • Membership Submission
  • Approve listings manually or automatically

Single Owner or Multiple Owners

  • How to use WPRentals as a single owner or site-admin website
  • How to use WPRentals with multiple owners
  • Login and Register setup

Booking, Calendar, and Guests

  • Theme Options – Booking Settings
  • How to enable Instant Booking
  • Increase the number of months in the calendar
  • How to setup hourly booking

Listing Fields, Price, and Location

  • Add, edit, and delete listing custom fields
  • Submit Listing Form: Price Details Explained
  • Location Options in Submit Listing Form
  • How to manage listing location with theme autocomplete
Property / Listing

Related Articles

  • How to Change Thumbnail / Images Sizes
  • How to work with the Listing Page Layout Manager
  • Login & Register – How to Create Renters / Owners
  • Virtual Tour in the Single Property Page

HELP CATEGORIES

  • 61. General
  • 72. Installation & Basic Setup
  • 373. How Booking Works
  • 18Advanced Search
  • 17Elementor WPRentals Studio
  • 14Email Notifications
  • 27FAQ
  • 14Installation FAQ
  • 10Menu Options
  • 33Owner & Renter
  • 8Page Templates
  • 24Property / Listing
  • 22Shortcodes
  • 4Supported Maps
  • 99Technical how to
  • 5Third Party plugins
  • 4Translation & Multi Languages
  • 3WordPress Blog Post
  • 13WordPress Widgets
  • 12WP Rentals Payments
  • 80WP Rentals Theme Options
  • 26WPML & Weglot

Join Us On

Powered by WP Estate - All Rights Reserved
  • Client Support
  • Video Tutorials
  • WPRentals
  • WPEstate
  • API