Add Listing Form
Add Listing Form
This page explains how listings are created and edited on your site.
One form, two places
Listings can be edited in two places, and both use the same listing editor:
| Where | |
|---|---|
| Admin | Listings → All Listings, then edit a listing. |
| Member | The member's own account area, on the front of your site, for a listing they own. |
Both save in exactly the same way, so a field works the same wherever it's edited. This is helpful when you add a custom field: you set it up once and it appears in both places.
What admins and members see
The form changes depending on who is filling it in.
Administrators see everything: status, author, web address (URL slug), featured and verified flags, and any field marked Edit Only.
Members see a simpler version that only covers their own listing. They can't make their own listing featured, hand a listing over to another user, or change fields you've kept for staff.
Mark a custom field Edit Only when it's for your own use, such as an internal reference, a moderation note or a commission rate.
What's in the form
The form is made of two parts.
Core fields, which every listing has: title, description, category, tags, featured image, gallery and FAQ entries.
Your custom fields, which are everything you've set up under Listings → Custom Fields. They're added to the form in the order you choose, and saved with the listing so the listing page can show them.
Together, those make up the whole form. There's no separate template to edit. When you change the custom fields, the form changes with them.
See Fields & Default Content to learn how to set them up.
Adding a field
- Go to Listings → Custom Fields.
- Add the field, choose its type, and decide whether members can edit it.
- That's it. It now appears in both editors, and on the listing page.
If you'd also like people to be able to filter by it, add a matching filter under Search → Search filters. Saving a field and searching on it are set up separately, so you'll need to do both.
What happens when you save
Listings are ordinary WordPress posts, and custom fields are saved as post meta under the field's key. There's nothing unusual about it, so if you ever export your site, your content is in the tables you'd expect.
Whether a new listing goes live straight away or waits for your review depends on your pricing plan, and on what Listings → Setup & Expiry says needs your approval. See Monetize.
If you'd like to add your own card to the form in code, see Adding your own features.