Documentation
Shortcodes & widgets.
Every shortcode, every block, every Elementor widget — with parameter reference and worked examples. Display properties, projects, agents, search forms anywhere.
Three ways to display content
Prop Nexia gives you three ways to show your inventory on the front of your site. Pick whichever fits how you build pages:
- Shortcodes — text-based. Works inside the page editor, theme PHP, sidebars and widgets.
- Gutenberg blocks — visual configuration in the block editor. No code.
- Elementor widgets — native widgets in the Elementor editor. No code.
All three call the same underlying templates. So a property card in a shortcode looks identical to one in a block or widget.
Property archive shortcode
Display a grid of properties:
[pn_properties limit="12" purpose="sale" city="dubai" community="dubai-marina"]Parameters
| Parameter | Description |
|---|---|
limit | How many properties to show. Default 12. Use -1 to show all. |
purpose | sale, rent, off-plan, or short-let. |
type | Property type — apartment, villa, townhouse, office, land. |
city | City slug — dubai, abu-dhabi, sharjah. |
community | Community slug — dubai-marina, jvc, downtown. |
min_pricemax_price | Price range in your default currency. Numbers only, no symbols or commas. |
beds | 1, 2, 3+ and so on. |
featured | Set to yes to show only featured listings. |
orderby | date (default), price, title, or random. |
order | ASC or DESC. Default is DESC. |
style | grid (default), list, or carousel. |
columns | 2, 3, or 4. Default 3. |
Worked examples
The 6 newest off-plan projects in Dubai Marina, displayed in a 3-column grid:
[pn_properties limit="6" purpose="off-plan" community="dubai-marina" columns="3"]Featured villas for sale, AED 5M to AED 20M, ordered by price ascending:
[pn_properties type="villa" purpose="sale" min_price="5000000" max_price="20000000" featured="yes" orderby="price" order="ASC"]A carousel of 8 random listings — good for a homepage section:
[pn_properties limit="8" style="carousel" orderby="random"]Search form shortcode
The search form is the single most important component on a property website. Drop it on your homepage hero, in your header, or on a dedicated search page:
[pn_search style="hero" purpose-toggle="yes" advanced="yes"]Parameters
| Parameter | Description |
|---|---|
style | hero (large, full-width), compact (single-row), or sidebar (vertical, narrow). |
purpose-toggle | Set to yes to show Sale and Rent tabs at the top. |
advanced | Set to yes to show min/max price, beds and baths fields. |
action | URL of your search results page. Defaults to /properties/. |
city_default | Pre-select a city — useful on city-specific landing pages. |
hero style is designed to sit inside a full-width section with a coloured or image background. Use compact for header bars and sidebar for filter panels on the side of your search results page.
Single property by ID or slug
Render a full single-property template anywhere on your site. Useful for hero placements, campaign pages, or featured listings on the homepage.
[pn_property id="123"]
[pn_property slug="marina-view-apartment"]Find the ID in the URL when editing a property in WordPress admin. The slug is the same as the URL path.
Project archive
Display off-plan projects. Same parameter style as the property shortcode, with a few extras:
[pn_projects limit="6" developer="emaar"]| Parameter | Description |
|---|---|
limit | How many to show. Default 12. |
developer | Developer slug — emaar, damac, nakheel. |
handover_year | Filter by handover year — 2026, 2027, 2028. |
community | Community slug. |
style | grid, list, or carousel. |
columns | 2, 3, or 4. |
Agent grid
Show your agency’s team:
[pn_agents limit="8" city="dubai"]Each agent card shows their photo, name, BRN, languages and contact options. Click-through goes to the agent’s profile page, which lists their current listings.
| Parameter | Description |
|---|---|
limit | How many agents to show. |
city | Filter by city. |
speciality | Filter by speciality — off-plan, luxury, rental, etc. |
columns | 2, 3, or 4. |
Area guide grid
Show community pages — Dubai Marina, Downtown, JVC and so on:
[pn_areas city="dubai" limit="12" columns="4"]Each card links to the area guide page, which lists all listings inside that community plus lifestyle and price info.
Compare and favourites
Visitors can save listings to favourites and add them to a side-by-side comparison. Place these shortcodes on dedicated pages:
[pn_favourites]
[pn_compare]The favourites page shows everything the visitor has saved. The compare page shows up to 4 properties side by side with their key details (price, beds, baths, area, amenities) in a single table.
Gutenberg blocks
Every shortcode above has a matching Gutenberg block with visual configuration. In the block editor, click + and search for Prop Nexia. You’ll see:
- Properties (archive)
- Property (single)
- Search form
- Projects
- Agents
- Area guides
- Compare
- Favourites
Each block has a sidebar panel with all the same parameters as the shortcode — but with proper labels, dropdowns and toggles. Recommended if you don’t write code.
Elementor widgets
If you have Elementor active, the same components appear as native Elementor widgets. Drag them onto your page from the widget panel. Visual configuration with Elementor’s responsive controls.
Find them under the Prop Nexia category in the Elementor widget panel.
Custom templates
To override the HTML that Prop Nexia renders, copy the template file from:
wp-content/plugins/prop-nexia/templates/Into your active theme at:
wp-content/themes/your-theme/prop-nexia/This is the standard WordPress template-override pattern. Your overrides survive plugin updates because we never touch your theme folder.
Common templates to override
card-property.php— the property card used in grids and lists.single-property.php— the full single-property page.archive-property.php— the property archive page layout.search-form.php— the search form fields and layout.card-project.php,card-agent.php,card-area.php— cards for other content types.