# Custom Fields

### Overview

Custom fields are a powerful tool to build content. We provide a variety of field types with the ability to outline into groups. Each field can be assigned into a single category or all categories.

### Creating a Custom Field

Creating a custom field involves setting certain options. To create a custom field, click New as shown in the following image.

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

**Screen 1: Custom Field screen**

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

<div id="bkmrk-new-creates-a-new-cu"><table><tbody><tr><td>**New**

</td><td>Creates a new Custom Field.

</td></tr><tr><td>**Edit**

</td><td>Provides the edit mode to make changes to the existing level or titles created.

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

</td><td>Publishes the created custom field.

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

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

</td></tr><tr><td>**Archive**

</td><td>Archives custom fields that are not used anymore.

</td></tr><tr><td>**Trash**

</td><td>Deletes the custom fields that are not required anymore.

</td></tr><tr><td>**Options**

</td><td>Navigates to the Extension options screen.

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

</div>### Editing Custom Fields

If you want to edit existing entries, you can either click the entry from the Custom Fields screen or select the checkbox next to the entry, and then click **Edit**.

#### Custom Field Edit

After you click the required entry that you need to edit, you can change the configurations for the fields as shown in the following image.

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

**Screen 2: Custom Field Edit tab**

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

<div id="bkmrk-custom-field-edit-ti"><table style="width: 100%;"><tbody><tr><td style="width: 13.7206%;">##### Custom Field Edit

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

</td><td style="width: 75.5261%;">Title for the Custom Field.

</td></tr><tr><td style="width: 13.7206%;"> </td><td style="width: 10.7533%;">**Alias**

</td><td style="width: 75.5261%;">URL alias for “SEF/SEO” URL.

</td></tr><tr><td style="width: 13.7206%;"> </td><td style="width: 10.7533%;">**Order**

</td><td style="width: 75.5261%;">Provide a value from 1 onwards. The lowest value will appear on the top.

</td></tr><tr><td style="width: 13.7206%;"> </td><td style="width: 10.7533%;">**Field Required?**

</td><td style="width: 75.5261%;">Enable whether to make the field required.

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

</td><td style="width: 75.5261%;">Category where the Custom Field will be published.

<div data-hasbody="true" data-macro-name="info"><div>When you select a custom field for a particular category, it is visible only for that category. While creating a listing if you select the said category and save, the custom field is available only then.</div></div></td></tr><tr><td style="width: 13.7206%;"> </td><td style="width: 10.7533%;">**Field Type**

</td><td style="width: 75.5261%;">Set the Field Type for the Custom Field. For more information, see the [Field Type Table](https://wiki.comdev.eu/display/JD2/Custom+Fields#CustomFields-FieldTypes).

</td></tr><tr><td style="width: 13.7206%;"> </td><td style="width: 10.7533%;">**Field Database Type**

</td><td style="width: 75.5261%;">Set the field type, needed for database settings.

- String - Used for text
- Decimal - Decimal number e.g. 10.060
- Integer - Number e.g. 1232

</td></tr><tr><td style="width: 13.7206%;"> </td><td style="width: 10.7533%;">**Field Group**

</td><td style="width: 75.5261%;">There are 5 custom field groups. Custom fields are grouped into groups. It has many advantages, one of them is display purposes. There are few groups available:

- Items - group displayed on the listings page under the description
- Item - group displayed on the left-hand side of the slideshow under detailed view.
- Tabs - special group to create own Tabs in detailed view.
- Features - special group for featured listings.
- Paid Items - Paid group displayed on the listings page under the description.
- Paid Item - Paid group displayed on the left-hand side of the slideshow under detailed view.

***JomEstate, JomEvents only***

- Location - group displayed under the Location Tab in listing details.

<div data-hasbody="true" data-macro-name="note"><div>Groups are static and cannot be created.</div></div><div data-hasbody="true" data-macro-name="note"><div>Paid groups are related to the [membership plans](https://wiki.comdev.eu/display/JD2/Membership) that are applied to custom fields. Paid Items are displayed in the Items list, while the Paid Item is displayed in an Item (detailed) view.</div></div></td></tr><tr><td style="width: 13.7206%;"> </td><td style="width: 10.7533%;">**Field Can Be Searched**

</td><td style="width: 75.5261%;">Enable to make the field values searchable.

<div data-hasbody="true" data-macro-name="note"><div>This setting applies only for the Search Module -&gt; Layout Filter.</div></div></td></tr><tr><td style="width: 13.7206%;"> </td><td style="width: 10.7533%;">**Field Search Type**

</td><td style="width: 75.5261%;">Provide the type of search option to include:

- Single Input Field Type
- Range Input Field Type
- Range Dropdown Field Type
- Range Slider

Depending on the Field search type you select, the search criteria field will be displayed in the search module – layout side search.

<div data-hasbody="true" data-macro-name="note"><div>This field is functional when the **Field Type is selected as Input** and **Field can be searched set to Yes**</div></div></td></tr><tr><td style="width: 13.7206%;"> </td><td style="width: 10.7533%;">**Minimum Value**

</td><td style="width: 75.5261%;">When, as an example, the Range Dropdown option is selected, you can select the range between which the options can be selected. For example, for Price range between X and Y, with incremental steps of 2, you can set x value in this field.

 ![](https://wiki.comdev.eu/download/attachments/4194543/JD_admin_custom_3.jpg)

</td></tr><tr><td style="width: 13.7206%;"> </td><td style="width: 10.7533%;">**Maximum Value**

</td><td style="width: 75.5261%;">Set the Y value for the range in this field.

</td></tr><tr><td style="width: 13.7206%;"> </td><td style="width: 10.7533%;">**Steps**

</td><td style="width: 75.5261%;">Define the incremental steps. For example, for increments of x+2, provide the value as 2.

</td></tr><tr><td style="width: 13.7206%;"> </td><td style="width: 10.7533%;">**Custom Field Template**

</td><td style="width: 75.5261%;">Custom fields have own templates that can be used and customized. There are 3 templates available:

- default
- horizontal
- horizontal float
- horizontal float + icon
- horizontal no label
- default no label

If you would like to create and customize your own templates, see the [Developer Guide](https://wiki.comdev.eu/display/JD2/Custom+Fields+Templates).

</td></tr><tr><td style="width: 13.7206%;"> </td><td style="width: 10.7533%;">**ID**

</td><td style="width: 75.5261%;">This field is auto - generated.

</td></tr><tr><td data-highlight-colour="blue" style="width: 13.7206%;">##### Custom fields values area

</td><td data-highlight-colour="blue" style="width: 10.7533%;">**Add new**

</td><td data-highlight-colour="blue" style="width: 75.5261%;">If the field type is selected to hold **multiple values**, this button lets you create the multiple values.

</td></tr><tr><td data-highlight-colour="blue" style="width: 13.7206%;"> </td><td data-highlight-colour="blue" style="width: 10.7533%;">**Delete**

</td><td data-highlight-colour="blue" style="width: 75.5261%;">Delete the value.

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

</div>##### Custom Field Values

This area lets you create values when the field type requires multiple options to be provided.

For custom fields that can have values, to add multiple values, navigate to the custom fields listing screen. Click the ![](https://wiki.comdev.eu/download/attachments/4194543/jd_customfield_icon.jpg) icon next to the field where you want to add values as shown in the following image.

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

**Screen 3: Adding values to custom fields area**

Here, the Field Type is selected as Checkbox and the Field Database Type has been stated as String. This means the Custom fields value area should provide options that can be seen when editing listing and displayed on the component front page. Hence, the Sample Values are provided in this area as Street, Garage, Underground. The following screen shows the values added at the back end. Click **Delete** to delete the entry.

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

**Screen 4: Values added to custom field area**

The following image shows how the field looks on the add listings page.

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

**Screen 5: Custom Field as seen on new listing page**

The custom field is seen on the listings page as shown in the following image:

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

**Screen 6: Custom Field as seen on published listing page**

##### Field Types

With Extension extension, you get several field types that you can create based on your requirement. The following image shows the available field types.

![](https://wiki.comdev.eu/download/attachments/4194543/Custom%20Field_Field_Types.jpg)

**Screen 7: Field Types**

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

<div id="bkmrk-type-multiple-select"><table><thead><tr><td data-highlight-colour="grey">**Type**

</td><td data-highlight-colour="grey">**Multiple select**

</td><td data-highlight-colour="grey">**Multiple Values**

</td><td data-highlight-colour="grey">**Description**

</td></tr></thead><tbody><tr><td>**Radio button**

</td><td>No

</td><td>Yes

</td><td>Standard radio button with multiple values

</td></tr><tr><td>**Checkbox**

</td><td>Yes

</td><td>Yes

</td><td>Standard check boxes with multiple values

</td></tr><tr><td>**Dropdown**

</td><td>No

</td><td>Yes

</td><td>Dropdown (select) field with multiple values

</td></tr><tr><td>**Multiple Select**

</td><td>Yes

</td><td>Yes

</td><td>Select box with multiple values

</td></tr><tr><td>**Input**

</td><td>No

</td><td>No

</td><td>Single text box

</td></tr><tr><td>**Web Address**

</td><td>No

</td><td>No

</td><td>Single text box for URL, it will display as the link in the front page

</td></tr><tr><td>**Email**

</td><td>No

</td><td>No

</td><td>Single text box for email

</td></tr><tr><td>**Text**

</td><td>No

</td><td>No

</td><td>Text area

</td></tr><tr><td>**Date Time**

</td><td>No

</td><td>No

</td><td>Select a date and time from the Calendar icon on screen.

</td></tr><tr><td>**Date**

</td><td>No

</td><td>No

</td><td>Select a date from the Calendar icon on screen.

</td></tr><tr><td>**Editor textarea**

</td><td>No

</td><td>No

</td><td>Creates a rich text editor box, it can be combined with Tabs group.

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

</div>#### Publishing tab

After you have provided the above information, you can provide the publishing information in the Publishing tab.

You can change the values for the given options using the following table.

<table id="bkmrk-status-based-on-the-" style="width: 100%;"><tbody><tr><td style="width: 15.3213%;">**Status**

</td><td style="width: 84.6787%;">Based on the status seen here, the visibility changes as follows:

- Published - Entries are visible on the front-end.
- Unpublished – Entries are invisible in the front-end, but can be published later.
- Archived – Older entries that are not ready for deletion yet.
- Trashed – Older entries that should be removed.

</td></tr><tr><td style="width: 15.3213%;">**Language**

</td><td style="width: 84.6787%;">Select the language for the address entry.

<div data-hasbody="true" data-macro-name="note"><div>To create a custom field that applies to a particular language, you need to select the appropriate language from the drop down. For each [language](https://wiki.comdev.eu/display/JD2/Multilingual+Site) that you want it to appear for, create a separate entry.</div></div></td></tr><tr><td style="width: 15.3213%;">**Created Date**

</td><td style="width: 84.6787%;">Date when the entry was created.

</td></tr><tr><td style="width: 15.3213%;">**Start Publishing**

</td><td style="width: 84.6787%;">Date when publishing needs to start in case of limited viewing of the field.

</td></tr><tr><td style="width: 15.3213%;">**Finish Publishing**

</td><td style="width: 84.6787%;">Date when publishing needs to stop in case of limited viewing of the field.

</td></tr><tr><td style="width: 15.3213%;">**Modified Date**

</td><td style="width: 84.6787%;">Date when the entry was modified.

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