All About Short Codes

Modified on Wed, 29 Oct at 11:40 AM

Introduction

To display content from your GuestWisely account on your website through GuestWisely, you first need to set up a few default WordPress pages and insert the appropriate short codes.


Applying Short Codes

Short codes let you display specific content from your GuestWisely account, such as property details, availability, or booking forms. After your pages are designed using Divi or another page builder), simply insert the required short codes.

Available shot codes include:

  • Search Bar: Embed one of two search form styles.

  • Featured Properties: Display selected properties, ideal for your homepage.

  • Properties: Show a paginated list of all properties with control over properties per row and per page.

  • Property: Display specific property features (description, amenities, gallery, etc.).

  • Booking: Embed the booking engine to allow direct reservations.

  • Guestwisely Login: Provide a login form for clients, owners, or team members to manage bookings.

  • Category Grid

  • Discounts Page

  • Review Page Grid & Submission Form

  • Saved Properties Results Page


Search Bar 

Basic Short code: [guestwisely-search]

Key Parameters:

Key Parameter

Type

Values

Default

Notes

style

string/

number

full, 1, 2

2

If numeric variants exist, enter a number

location

string

homepage, searchpage

Syncs with GuestWisely settings

size (homepage)

string

small, medium, large

large

Homepage only

showfilter (results)

bool

true, false

FALSE

Results page only

searchpageid

number

123 …

null

Use a specific results page ID

usecurrentpageforsearch

bool

true, false

FALSE

Route results to current page

defaultquery

string

any

null

Preload criteria


Minimal snippet: [guestwisely-search style=full location=homepage]

Tips:

  • If a value is a number, you must input the specific number (e.g., searchpageid=123).

  • If Default Value = null, the parameter is optional

  • Location controls which GuestWisely search bar settings are applied (Homepage vs Searchpage).

  • Size applies only to location=homepage.

  • Showfilter applies only to location=searchpage.

Example Short codes

1. Homepage Search Bar (Full Width, Large Size): 
[guestwisely-search style=full location=homepage size=large]




2.Search Results Page (With Advanced Filter):

[guestwisely-search style=full location=searchpage showfilter=true]



Connect Your Website to GuestWisely

The Featured Properties short code allows you to display a row or grid of properties that you have marked as featured in your GuestWisely account. This is typically placed on your homepage to highlight selected properties and attract more bookings.

Basic short code: [guestwisely-featured-properties]

Key Parameters:

Key parameter

Values

Default

Notes

perrow

number

3

Cards per row

limit

number

3

Max items shown

propertypageid

null

null

Target page ID for property detail/list (optional)

propertiesdiscountspageid

null

null

Target page ID for discounts list (optional)

showsavebutton

true, false

FALSE

Show “Save” on cards

showfeaturedlabel

true, false

TRUE

Show “Featured” label





  • If a value is a number, you must input a specific number (e.g., searchpageid=123).

  • If Value = null, the parameter is optional

Example Short codes:

1. Display 2 properties per row, showing 4 properties total:

[guestwisely-featured-properties perRow=2 limit=4]



Properties Listings

The Property listings display is largely configured in the top level plugin settings. These can be overwritten using some of the parameters below, if you wish to duplicate the short code in more than one area, for different purposes.

Basic short code: guestwisely-properties-list

Key Parameters:

Key parametersValuesDefault Notes
perrownumber3Cards per row (primarily used in grid view)
perpagenumber10Items per page
propertypageidnullnullTarget page ID for property details
propertiessearchpageidnullnullTarget results page ID (if not using current page)
propertiesdiscountspageidnullnullTarget page ID for discounts list
usecurrentpageforsearchtrue, falseFALSERoute search results to current page
discountsonlytrue, falseFALSEShow only discounted properties
showsavebuttontrue, falseFALSEShow “Save” on cards
showdiscountlabeltrue, falseTRUEShow “Discount” label
showfeaturedlabeltrue, falseTRUEShow “Featured” label
viewlist, grid, maplistChoose layout view
mapstyleDefault, fulldefaultHalf or full page map view
defaultquerynullnullPreload filters (e.g., dates, location); leave blank to skip

 

Tips:

  • Grid tuning: perrow only affects grid; it has no effect on list or map.
  • Routing: Prefer usecurrentpageforsearch=true or set propertiessearchpageid—avoid mixing both unless you need a fallback.
  • Discounts-only: You can still keep tabs on, or hide them for a focused layout.
  • Map view: Ensure your map settings/API are configured in the theme/plugin when using view=map.

Use-case Recipes (copy → paste)

Use caseShort code
Standard list (12 per page)[guestwisely-properties-list view=list perpage=12]
Grid view (4 per row, 12 per page)[guestwisely-properties-list view=grid perrow=4 perpage=12]
Discounts-only grid, minimal UI (no save, no labels)[guestwisely-properties-list view=grid discountsonly=true showsavebutton=false showfeaturedlabel=false showdiscountlabel=false]
Use current page for search results routing[guestwisely-properties-list usecurrentpageforsearch=true]
Map view (default style, larger page)[guestwisely-properties-list view=map perpage=20 mapstyle=default]
Explicit target pages[guestwisely-properties-list propertypageid=123 propertiessearchpageid=456 propertiesdiscountspageid=789]


Example Short codes

1. Standard Grid View (2 properties per row, 10 per page):

[guestwisely-properties-list perRow=2 perPage=10]

2. Full Map View with Save Button Enabled:

[guestwisely-properties-list mapstyle=full showsavebutton=true]

Category Grid

Display your property categories as a visual grid — all photos configured within your Guestwisely account. This layout provides an intuitive way for users to browse your property categories.

You can customize how many categories appear per row using the perrow parameter.

Note: Be sure to choose a grid layout that fits the exact number of categories you have in your account, as the grid will only display full rows.

Basic short code: [guestwisely-category-grid]

Key Parameters: 

Key parameterValueDefault Notes
perrownumber4Category tiles per row
searchpageidnullnullTarget results page ID (optional)


Use-case Recipes (copy → paste)

Use caseShort code
Default grid (4 per row)[guestwisely-category-grid]
Compact grid (3 per row)[guestwisely-category-grid perrow=3]
Wide grid (5 per row)[guestwisely-category-grid perrow=5]

Example Short code

[guestwisely-category-grid perrow=3]



Property Page
To build the various elements of your ‘property’ page default page you need to add each specific feature that you want to include as a short code in the location that you want to include it. The building blocks for each section are as follows: [guestwisely-property section=SECTION_NAME].

So, for example, if you want to include any of the elements below you would need to include the short code: [guestwisely-property section=SECTION_NAME]

Replacing the section=SECTION_NAME with the value for the ‘section’ attribute that you want to include.


Please note: the short codes may not render their modules in a visual builder, depending on the theme you are using.


Key Parameters: 

Short codeSectionParameterValueDefaultNotes
guestwisely-propertyBannershowintroboxtrue,falseTRUEShows property description on first slide
lightboxonlytrue,falseFALSEDisables photo slider and opens lightbox instead.
Imagescroller


Adds thumbnail slider - will only function when used in addition to banner section

Use-case Recipes (copy → paste)

Use caseShort code  
Banner (default – intro box ON)[guestwisely-property section=banner]
Banner (hide intro box)[guestwisely-property section=banner showintrobox=false]
Banner (lightbox only)[guestwisely-property section=banner lightboxonly=true]
Image scroller[guestwisely-property section=imagescroller]

Example Short codes

[guestwisely-property section=banner showintrobox=false]
[guestwisely-property section=imagescroller]


Booking Widget

Mandatory to allow the streamlined process from property search to booking.

Key Parameters 

Short codeSectionParameterValueDefault
guestwisely-propertyquotewidget


modaltrue, falseFALSE
floatercontactPageUrlnullnull
bookingPageUrlnullnull
showdiscountstrue, falseFALSE

Use-case Recipes (copy → paste)

Use caseShort code
Quote widget (default, inline)[guestwisely-property section=quotewidget]
Quote widget (open in modal from footer tab)[guestwisely-property section=quotewidget modal=true]
Floater widget (default)[guestwisely-property section=floater]
Floater with Contact link[guestwisely-property section=floater contactPageUrl="/contact"]
Floater with Booking link[guestwisely-property section=floater bookingPageUrl="/book-now"]
Floater showing discounts[guestwisely-property section=floater showdiscounts=true]
Floater with both links + discounts[guestwisely-property section=floater contactPageUrl="/contact" bookingPageUrl="/book-now" showdiscounts=true]


Example Short code

[guestwisely-property section=quotewidget modal=true]


Property Title

Key Parameters 

Short code

Section

Parameter

Value

guestwisely-property

name

tag

H1

name

name

seoValue

null

Use-case Recipes (copy → paste)

Use case

Short code

Default title (H1)

[guestwisely-property section=name]

Explicit H1 tag (same as default)

[guestwisely-property section=name tag=h1]

Override SEO title (optional)

[guestwisely-property section=name seoValue='Beachfront Villa – Koh Chang']

H1 with SEO override

[guestwisely-property section=name tag=h1 seoValue='Beachfront Villa – Koh Chang']


Property Description

Key Parameters 

Short code

Section

Parameter

Value

Default

guestwisely-property

brief

readmore

true

false

tag

default

Div

Use-case Recipes (copy → paste)

Use case

Short code

Default property description

[guestwisely-property section=brief]

“Read more” toggle (if supported in your build)

[guestwisely-property section=brief readmore=true]

Explicit wrapper tag = div (same as default)

[guestwisely-property section=brief tag=div]

Example Short code

[guestwisely-property section=brief readmore=true]


Room Icons

Short code

Section

Notes

guestwisely-property

Rooms

Values of max guests, bedroom and bathrooms taken from the property profile of your GuestWisely account


Property Video

Key Parameters 

Short code

Section

Parameter

Value

Default

guestwisely-property

virtualtour

lightbox

true, false

FALSE

textonly

true, false

FALSE

embed

true, false

FALSE

showimagewhennovideo

true, false

TRUE

Use-case Recipes (copy → paste)

Use case

Short code

Virtual tour / video (default)

[guestwisely-property section=virtualtour]

Open video in lightbox

[guestwisely-property section=virtualtour lightbox=true]

Text-only link (no thumbnail)

[guestwisely-property section=virtualtour textonly=true]

Embed player inline

[guestwisely-property section=virtualtour embed=true]

Hide fallback image when no video

[guestwisely-property section=virtualtour showimagewhennovideo=false]

Lightbox + explicit fallback

[guestwisely-property section=virtualtour lightbox=true showimagewhennovideo=true]

Embed inline + hide fallback

[guestwisely-property section=virtualtour embed=true showimagewhennovideo=false]


Save Properties Icon

Key Parameter 

Short code

Section

Parameter

Value

Default

guestwisely-property

savebutton

showtext

True, false

TRUE

See below for the second part of the saving properties module: saved property counter.


Map 

Key Parameters 

Short codeSectionParameterValueDefault
guestwisely-propertymap


valueoption["latitude" => "lat",
"longitude" => "lon"]
localinformation


Use-case Recipes (copy → paste)

Use caseShort code
Map (default keys)[guestwisely-property section=map]
Map with explicit lat/lon mapping (default)[guestwisely-property section=map value='["latitude"=>"lat","longitude"=>"lon"]']
Local Information[guestwisely-property section=localinformation]


Amenities
Key Parameters 

Short codeSectionParameterValueDefaultNotes
guestwisely-propertyamenitiesshowoverviewtrue, falseFALSEShows property overview amenities
amenitiesspecificroomstrue, falseTRUEshows individual room amenities

Use-case Recipes (copy → paste)


Rates Table

Use case

Short code

Amenities with room specific

[guestwisely-property section=amenities]

Overview only 

[guestwisely-property section=amenities amenitiesspecificrooms=false showoverview=true]

Key Parameters 

Short code

Section

Parameter

Value

Default

guestwisely-property

rates

showratedates

true, false

TRUE

showratename

true, false

TRUE

Use-case Recipes (copy → paste)

Use case

Short code

Rates table (default: show dates & names)

[guestwisely-property section=rates]

Hide date ranges

[guestwisely-property section=rates showratedates=false]

Hide rate names

[guestwisely-property section=rates showratename=false]


Reviews Module

Short code

Section

Notes

guestwisely-property

reviews

All configured within your Reviews Module in your GuestWisely account

Policies

Key Parameters 

Short code

Section

Parameter

Value

Default

guestwisely-property

policies

readmore

true, false

FALSE


Booking/Availability Calendar

Key Parameters 

Short code

Section

Parameter

Value

Default

Notes

guestwisely-property

booking

style

optional

null

Style=1 – NextGen Riviera Suite

Style=2 – NextGen Camelot Suite

singleproperty

True, false

FALSE

Disable property switcher

displaymonths

optional

null

Choose no. of months on display

showdiscounts

true, false

FALSE

Show discount spots on dates

includebeyondpricing

true, false

FALSE

Optional

Use-case Recipes (copy → paste)

Use case

Short code

Booking/availability (basic, default)

[guestwisely-property section=booking]

Style 1 (Riviera Suite)

[guestwisely-property section=booking style=1]

Show discounts in widget

[guestwisely-property section=booking showdiscounts=true]

Two months visible

[guestwisely-property section=booking displaymonths=2]

Include Beyond Pricing

[guestwisely-property section=booking includebeyondpricing=true]

Display 2 months with discounts

[guestwisely-property section=booking showdiscounts=true displaymonths=2]

Example Short code

[guestwisely-property section=booking displaymonths=2 singleproperty=true]

Key Parameters 

Short   code

Section

Parameter

Value

Default

guestwisely-property

Related

limit

number

3


Booking Page

To enable you to embed a booking engine. Which works real time with your availability within your GuestWisely account. To be placed on a hidden booking page as the final step in the booking process from search bar > floating/inline/modal booking widget > booking engine.

Key Parameters 

Short code

Parameter

Value

Default 

Notes

guestwisely-booking

style

1,2

null

style=1 – NextGen Riviera Suite

style=2 – NextGen Camelot Suite

singleproperty

True, false

FALSE

Disable property switcher or for use on single property pages

displaymonths

number

null

Months visible in the date picker 

(3 per row max) 

showdiscounts

true,false

FALSE

Discount dates highlighted

Use-case Recipes (copy → paste)

Use case

Short       code

Basic booking widget

[guestwisely-booking]

Single property page

[guestwisely-booking singleproperty=true]

Show discounts

[guestwisely-booking showdiscounts=true]

Two months visible

[guestwisely-booking displaymonths=2]


Login Form

The ability to embed a login form for property owners and team members, to enable owners to login to access their dashboard and review their calendar and owner statement.

Basic Short code: [guestwisely-login]


Language Switcher

Key Parameters : [guestwisely-language-switcher]


Discounts Page

Full Short code: [guestwisely-properties-list usecurrentpageforsearch=true discountsonly=true view=grid]

This is a variation of the property listing short code and must be used in full to display your discounted properties only. Instead of property descriptions, it displays the offer and information that the display price has already been adjusted in listings. Don’t forget to assign your discount page in GuestWisely plugin settings.

Tip: Create a duplicate of your search results page then update the page banner and replace the listings short code with the above. Assign this page in the GuestWisely Plugin Settings below:


This will show the shared property count containing the link to access the saved results.

Tip: Use this short code in one of your global website templates eg. the header/topbar or a floating tab attached to the side of the browser – so this can be accessed at all times.

Basic Short code: [guestwisely-saved-properties]



Review Page Grid & Submission Form

Basic Short code: [guestwisely-reviews]

Key Parameters 

Short code

Parameter

Value

Default 

Notes

guestwisely-reviews

display

Grid, form

grid

Grid: Displays a grid of your reviews, formatted in Guestwisely account

Form: Review Page Submission Form

Use-case Recipes (copy → paste)

Use case

Short code

Reviews grid (default)

[guestwisely-reviews]

Reviews grid (explicit)

[guestwisely-reviews display=grid]

Review submission form

[guestwisely-reviews display=form]





Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article