# Manage Listings

## Overview

You can view all the listings created for your site or create a new listing. The listings created let you add descriptions, images, provide ratings, and much more.

## Creating a New Listing

The following image shows the Listings screen.

[![obraz.png](https://wiki.comdev.eu/uploads/images/gallery/2024-03/scaled-1680-/HUeobraz.png)](https://wiki.comdev.eu/uploads/images/gallery/2024-03/HUeobraz.png)**Screen 1: Listing screen**

The following table explains the different options seen on the screen.

<div id="bkmrk-button-usage-insert-"><table><thead><tr><td data-highlight-colour="blue">**Button**

</td><td data-highlight-colour="blue">**Usage**

</td></tr></thead><tbody><tr><td>**Insert New**

</td><td>Creates a new listing entry. You must create separate entries for each level of depth that you need.

</td></tr><tr><td>**Publish**

</td><td>Publishes the created listing entry.

</td></tr><tr><td>**Unpublish**

</td><td>Removes the entry from the list of published entries.

</td></tr><tr><td>**Delete**

</td><td>Deletes the listing entry that is not required anymore.

</td></tr></tbody></table>

</div>## Adding a new listing

To create a new listing, click **Add New** from the Dashboard Menu list. The new listing page is displayed.

#### New Listing tab

This tab provides options to add title, description, select category, and other options for the Listing as seen in the following image:

The following table shows the options available:

<div id="bkmrk-area-options-usage-e"><table style="width: 100%;"><thead><tr><td data-highlight-colour="blue" style="width: 16.1821%;">**Area**

</td><td data-highlight-colour="blue" style="width: 69.4792%;">**Options**

</td><td data-highlight-colour="blue" style="width: 14.2151%;">**Usage**

</td></tr></thead><tbody><tr><td style="width: 16.1821%;">**Edit Listing area**

</td><td style="width: 69.4792%;">Title

</td><td style="width: 14.2151%;">Title for the Listing.

</td></tr><tr><td style="width: 16.1821%;">**Text Area**

</td><td style="width: 69.4792%;">Provide a description for the listing.

</td></tr><tr><td style="width: 16.1821%;">**Short Description**

</td><td style="width: 69.4792%;">Provide a short description for the listing.

</td></tr><tr><td style="width: 16.1821%;">**Article *Button***

</td><td style="width: 69.4792%;">Click to select a relevant article. If an article is provided, it can be seen under the Details tab in the listing.

<div data-hasbody="true" data-macro-name="note"><div>***Buttons*** for the editor are available when enabled under Site Backadmin -&gt; Plugins and WYSIWYG editor turned On in Joomla Configuration.</div></div></td></tr><tr><td style="width: 16.1821%;">**Page Break *Button***

</td><td style="width: 69.4792%;">Insert a page break in the displayed text.

</td></tr><tr><td style="width: 16.1821%;">**Toggle editor *Button***

</td><td style="width: 69.4792%;">Toggle between plain text and rich text editor

</td></tr><tr><td style="width: 16.1821%;">**Read More Button**

</td><td style="width: 69.4792%;">Insert a separation for creating short description. Any content above the dotted line is displayed as the short description.

<div data-hasbody="true" data-macro-name="info"><div>In the above image, the red dotted line appears when you click **Read More**. Any content above the red line is the **short description**, while the entire content is the **long description**. Also, note that if there is no content after the **Read More** tag, the event description will be blank when users view the listing. Ensure that you have content after the **Read More** tag.</div></div></td></tr><tr><td style="width: 16.1821%;">**Status**

</td><td style="width: 69.4792%;">Select the required status.

- Published
- Unpublished
- Trashed
- Archived

</td></tr><tr><td style="width: 16.1821%;">**Featured**

</td><td style="width: 69.4792%;">Enable to make the listing appear as featured listing.

<div data-hasbody="true" data-macro-name="note"><div>Feature Count is being checked when saving listing for the selected Membership Plan.</div></div></td></tr><tr><td style="width: 16.1821%;">**Language**

</td><td style="width: 69.4792%;">Select the language for which the listing needs to appear for. For [multiple languages](https://wiki.comdev.eu/books/installation-requirements-language/page/multilingual-site "Multilingual Site"), you must create separate entries for each language.

</td></tr><tr><td style="width: 16.1821%;">**Category**

</td><td style="width: 69.4792%;">Category where the listing will be published.

</td></tr><tr><td colspan="1" style="width: 16.1821%;">**Category Type**</td><td colspan="1" style="width: 69.4792%;">Category Type such as house, apartment and so on based on the category types for your site.</td></tr><tr><td colspan="1" style="width: 16.1821%;">**Energy Class**</td><td colspan="1" style="width: 69.4792%;">Select the energy class for the listing.</td></tr><tr><td style="width: 16.1821%;">**Address area**

</td><td style="width: 69.4792%;">Address

</td><td style="width: 14.2151%;">Address of the listing

</td></tr><tr><td style="width: 16.1821%;">**Full address**

</td><td style="width: 69.4792%;">Street and house number of the listing - If both Address and Full Address specified, map location will position automatically.

</td></tr><tr><td style="width: 16.1821%;">**Location area**

</td><td style="width: 69.4792%;">Maps latitude

</td><td style="width: 14.2151%;">It utilizes the GEO-location based on Google Maps.

Provide the latitude information for the location mapping.

</td></tr><tr><td style="width: 16.1821%;">**Maps longitude**

</td><td style="width: 69.4792%;">The information provided in this field is used to map the exact location. It utilizes the GEO-location based on Google Maps.

Provide the longitude information for the location mapping.

</td></tr><tr><td style="width: 16.1821%;">**Maps Search**

</td><td style="width: 69.4792%;">Search for a specific location. Type in the location and press Enter to go to the exact location.

</td></tr></tbody></table>

</div><div data-hasbody="true" data-macro-name="tip" id="bkmrk-for-more-information"><div>For more information about how the location mapping is done in the listing, see [Listings](http://confluence.comdev.eu/display/JE/Listings) in the Administrative Guide.</div></div>#### Custom Fields area

This area includes all the custom fields created for a particular category. If the custom field is not applied to a specific category, it can be seen for all categories when creating a listing. The following image shows the Custom Fields tab screen.

For more information about creating custom fields, see [Custom Fields](https://wiki.comdev.eu/books/jomevents/page/custom-fields "Custom Fields").

#### Images tab

[![obraz.png](https://wiki.comdev.eu/uploads/images/gallery/2024-02/scaled-1680-/mexobraz.png)](https://wiki.comdev.eu/uploads/images/gallery/2024-02/mexobraz.png)

**Screen 5: Images tab**

To add an image, do the following:

Click **Add Image**.

Provide options as seen in the following image.![](https://wiki.comdev.eu/download/attachments/5735004/Listings_Images1.jpg)

You can provide values using the following table.

<div id="bkmrk-title-or-alias-provi"><table><tbody><tr><td>**Title or alias**

</td><td>Provide a title for the Image.

</td></tr><tr><td>**Categories**

</td><td>Select from the following options:

- Slideshow - detailed view main gallery
- Gallery - in gallery tab
- Features- displayed under features.

</td></tr><tr><td>**Status**

</td><td>Select the required status.

- Published
- Unpublished

</td></tr><tr><td>**Order**

</td><td>Order in which you want the image to appear.

</td></tr><tr><td>**File**

</td><td>Click Choose File and provide the image.

</td></tr><tr><td>**Description**

</td><td>Provide a description about the image.

</td></tr></tbody></table>

Click **Save**.</div>For more information about editing images or deleting images, see [Images](http://confluence.comdev.eu/display/JE/Listings) in the Administrative Guide.

You can also provide YouTube video links for the listing. Provide the link as shown in the above image.

#### Attachments tab

Click the ![](https://wiki.comdev.eu/download/attachments/5735004/Listings_edit_icon.jpg)Edit icon to edit an attachment that is linked to the listing. Click the ![](https://wiki.comdev.eu/download/attachments/5735004/Listings_close_icon.jpg) Delete icon to delete the attachment.

Attachments are detected automatically based on file extension that’s are allowed in Configuration.

Some features or tabs are enabled based on the user membership. If the user is attached to a membership plan that does not allow adding attachments, he will not be able to see any options under the Attachments tab. These membership limitations are checked for when you save the listing.