Basic concepts
What dynamic content is
A dynamic block shows information on your website that you already have loaded in Orbis Portal: offers, tours, destinations, hotels… When you add or edit a product, the page updates itself.
To insert it, you use a shortcode: a line in square brackets that indicates what to show and how. You don't have to write it yourself: a form generates it for you.
[widget_ofertas data-destinos=3173 data-template=3columnas data-limit=6]
| Part | What it means |
|---|---|
widget_ofertas |
The module: here, offer boxes. |
data-destinos=3173 |
Filter by destination. The number is the internal identifier the system assigns when you choose the destination from the list. |
data-template=3columnas |
Layout: three columns. |
data-limit=6 |
Maximum number of items. |
ImportantAlways generate shortcodes from the formNumeric identifiers are different on every website. Don't copy the example shortcodes from this manual or edit them by hand: if you need a change, generate it again.
Common procedure
The 6 steps, valid for all modules
Open the pageContent (CMS) › Pages. Edit a page or create a new one.
Open the generatorClick the green </> button in the bottom-right corner.
Configure the moduleExpand the module and fill in the filters you need.
Generate and copyClick Generate and copy using the icon next to the Shortcode field.
Paste into ContentIn the editor, in its own paragraph, wherever you want the block. If the page uses the Web builder, paste it into a Widget element.
Save and reviewRepeat for each language, save, and check using "View page".
Page Creation / EditingBack to list
Content on the website EditorWeb builderWeb builder
SpanishEnglish…6
Seasonal getaways
Discover our seasonal getaways:
[widget_ofertas data-destinos=3173 data-template=3columnas data-limit=6]2
Dynamic Content Generation×
OFFERS 3With this option, we will generate codes (shortcodes) to insert into the page content that will display offer boxes on the page.
TOURSWith this option, we will generate codes (shortcodes) to insert into the page content that will display tour boxes on the page.
BROCHURESWith this option, we will generate codes (shortcodes) to insert into the page content that will display brochure boxes on the page.
DESTINATIONSWith this option, we will generate codes (shortcodes) to insert into the page content that will display destination boxes on the page.
EVENTSWith this option, we will generate codes (shortcodes) to insert into the page content that will display event boxes on the page.
HOTELSWith this option, we will generate codes (shortcodes) to insert into the page content that will display hotel boxes on the page.
SEARCHWith this option, we will generate URLs or insert a search form.
BLOG POSTS NEWWith this option, we will generate codes (shortcodes) to insert into the page content that will display blog post boxes on the page.
FLIGHTS NEWWith this option, we will generate codes (shortcodes) to insert into the page content that will display flight boxes on the page.
IMAGE GALLERY NEWWith this option, we will generate codes (shortcodes) to insert image galleries into pages.
MAPS NEWWith this option, we will generate codes (shortcodes) to insert maps into pages.
Carousel NEWWith this option, we will generate codes (shortcodes) to insert image sliders into pages.
FORMSWith this option, we will generate codes (shortcodes) to insert into the page content that will display form boxes on the page.
VIDEO NEWWith this option, we will generate codes (shortcodes) to insert videos into the page content.
Close
ImportantIf the page uses the Web builder, the shortcode goes in a WidgetThe Content field is only shown on the website when the Content on the website selector in the page form is set to Editor (the default option). If it is set to Web builder, add a Widget element in the builder and paste the shortcode there. More details in the Web builder manual.
Find your module
What do you want to show?
OffersPromotions and last-minute dealsBy destination, category or tag, with countdown.
ToursTours and organized tripsFeatured on the homepage or by country and type.
BrochuresCatalogs to browseCovers of brochures and catalogs.
DestinationsDestinations or regionsWith optional map.
EventsTickets and activitiesBy area or provider.
HotelsMost viewed or booked hotelsTrends that refresh themselves.
SearchA search engine or a linked searchHotel or flight + hotel.
Blog postsBlog articlesGuides and destination content.
FlightsFlight destinations from a countryBoxes and link lists.
GalleryA photo galleryImages from your files.
MapsA mapCreated in Content › Maps.
CarouselAn image sliderCreated in Content › Carousel.
FormsA formContact or request form.
VideoA YouTube or Vimeo videoWith automatic thumbnail.
Module
Offers
What it's for
Shows boxes with your offers, filtered by a specific offer, category, tag or destination.
When to use it
On the homepage, on seasonal landing pages ("December long weekend") or on each destination's page.
Dynamic Content Generation×
OFFERSWith this option, we will generate codes (shortcodes) to insert into the page content that will display offer boxes on the page.
[widget_ofertas data-destinos=3173 data-template=3columnas data-limit=6 data-text=Últimas plazas data-countdown=10]
Benidorm
3 columns
Masonry layout
6
Last-minute deals
Container
Show filters i
Show countdown i 4
10
Step by step
- Choose one or more Destinations (or filter by Categories, Tag or specific Offers).
- Select the Layout (1 to 5 columns) and enter the maximum number of offers.
- Optional: enter a short Highlight text. It appears at the top of each offer.
- Optional: check Show countdown. By default it starts 7 days before expiry; change it in "Countdown start in days".
- Click Generate and copy the shortcode.
| Field | What it does |
|---|---|
| Offers · Categories · Tag · Destinations | Filter which offers appear. Multiple values allowed. |
| Layout · Masonry layout | 1 to 5 columns; Masonry arranges the boxes in a mosaic layout. |
| Maximum number of offers | Limit of visible offers. |
| Show filters | Adds filters for the visitor. If enabled, you can't choose a specific layout. |
[widget_ofertas data-destinos=3173 data-template=3columnas data-limit=6 data-text=Últimas plazas data-countdown=10]
Common mistakeThe block appears emptyNo published offer matches the filter (for example, a destination with no active offers). Broaden the filter or check the offers in Content › Offers.
Module
Tours
What it's for
Shows tours filtered by a specific tour, type, tag, country or destination, or those you've marked to feature on the homepage.
When to use it
On the homepage to highlight your star tours, or on themed pages ("Tours across Europe").
Dynamic Content Generation×
TOURSWith this option, we will generate codes (shortcodes) to insert into the page content that will display tour boxes on the page.
[widget_circuitos data-template=3columnas data-limit=6]
RelatedGroupedFeatured i1
ToursTour typeTagsCountryDestinations2
3 columns
6
Container
Show filters i
Step by step
- Check Featured to show the tours that have "Show on homepage" enabled in their record.
- If you're not using Featured, choose the criterion (Tours, Tour type, Tags, Country or Destinations) and select the values. With Featured checked, these options are disabled.
- Choose the Layout: 1 column (Highlighted) or 2 to 5 columns, and the maximum number.
- Click Generate and copy the shortcode.
Advantage of "Featured"To change the visible tours you don't need to touch the page: just check or uncheck "Show on homepage" on each tour.
[widget_circuitos data-template=3columnas data-limit=6]
Common mistakeI can't choose the layoutYou have "Show filters" enabled. They're incompatible: disable it if you need a specific layout.
Module
Brochures
What it's for
Shows the covers of your catalogs or brochures for customers to browse.
When to use it
On a "Catalogs" page, or alongside a tour operator's offer or a season's offer.
Dynamic Content Generation×
BROCHURESWith this option, we will generate codes (shortcodes) to insert into the page content that will display brochure boxes on the page.
[widget_folletos data-template=4columnas data-proporcion=3by4]
CatalogsBrochuresTags1
4 columns
3 wide x 4 tall
Container
Step by step
- Choose what to show: Catalogs, Brochures or by Tags, and select the items in the field below.
- Choose the Layout: 1 to 6 columns.
- Choose the Aspect ratio for the covers. For brochures, a vertical format (3×4 or 2×3) is usually best.
- Click Generate and copy the shortcode.
[widget_folletos data-template=4columnas data-proporcion=3by4]
Common mistakeCovers appear croppedThe chosen aspect ratio doesn't match your covers. Try a different ratio and check the result with "View page".
Module
Destinations
What it's for
Shows destination boxes, individually or by grouping (for example, a whole region), with an optional map.
When to use it
On region pages ("Costa Blanca") or on a destinations index page.
Dynamic Content Generation×
DESTINATIONSWith this option, we will generate codes (shortcodes) to insert into the page content that will display destination boxes on the page.
[widget_destinos data-agrupacion_destinos=143 data-template=4columnas data-limit=8]
GroupingDestinations1
Alicante
4 columns
Masonry layout
8
Container
Create Map3
Step by step
- Choose Grouping (a whole region) or Destinations (one by one) and select them.
- Choose the Layout (1 to 5 columns, with optional Masonry) and the maximum number.
- Optional: check Create Map to add a map with the destinations.
- Click Generate and copy the shortcode.
[widget_destinos data-agrupacion_destinos=143 data-template=4columnas data-limit=8]
Common mistakeA destination is missingCheck the maximum number: if the grouping has more destinations than the specified limit, only the first ones are shown.
Module
Events
What it's for
Shows tickets, activities and events for a product class, filtered by area or provider.
When to use it
To complement a destination with activities, or on a tickets and experiences page.
Dynamic Content Generation×
EVENTSWith this option, we will generate codes (shortcodes) to insert into the page content that will display event boxes on the page.
[widget_eventos data-ids_clases=134 data-template=3columnas data-limit=6]
Tickets
3 columns
6
Container
Create Map
Step by step
- Select the product Class (for example, Tickets).
- Optional: narrow down by Areas or by Providers.
- Choose the Layout (1 to 5 columns), the maximum number and, if you want, Create Map.
- Click Generate and copy the shortcode.
[widget_eventos data-ids_clases=134 data-template=3columnas data-limit=6]
Common mistakeNothing to choose appears in Areas or ProvidersYou must select the Class first.
Module
Hotels
What it's for
Shows hotels based on a criterion: most viewed, most booked, featured, or the most searched cities.
When to use it
For trend blocks ("Most booked this month") that refresh without any intervention.
Dynamic Content Generation×
HOTELSWith this option, we will generate codes (shortcodes) to insert into the page content that will display hotel boxes on the page.
[widget_hoteles data-origen=reserva data-id_superclase=1 data-id_clase=1 data-periodo=30 data-limit=8]
Most Booked
Hotels
stays
CountryCity3
NONE
Last month
8
Container
Step by step
- Choose the Source: Most viewed, Most booked, Cities of the most searched hotels, Featured hotels (Swiper, in carousel) or Featured hotels (List).
- Select the Superclass module. The Class module is filled in based on your configuration.
- Optional: narrow down by Country or City.
- In View data from, choose the period (from the last week to the last year) and set the maximum number.
- Click Generate and copy the shortcode.
[widget_hoteles data-origen=reserva data-id_superclase=1 data-id_clase=1 data-periodo=30 data-limit=8]
Common mistakeToo few hotels with a short periodWith "Last week" there may be few bookings or visits. Extend the period if the block comes up short.
Module
Search
What it's for
Inserts a search engine into the page (Form) or generates a link to an already prepared search (URL).
When to use it
On destination landing pages, with the search engine already pre-set, or for a "View hotels in…" button that opens the filtered search.
Dynamic Content Generation×
SEARCHWith this option, we will generate URLs or insert a search form.
FLIGHT + HOTEL
Step by step
- In Select the Class, choose the search type: HOTEL or FLIGHT + HOTEL.
- Choose URL (link) or Form (embedded search engine).
- Preload, if you want, the origin (airport), destination, outbound and return dates, radius and occupancy.
- Adjust the Hotel filters or Flight filters, generate the result and copy it.
| Field | Options |
|---|---|
| Origin · Destination | Departure airport; reference city, area, town or hotel. |
| Outbound · Return · Radius | Travel dates and distance to the reference point (0.5 to 100 km). |
| Occupancy | Adults and children per room; "Add room" for more. |
| Hotel filters | Board type (from room only to all-inclusive), star category, accommodation type and free cancellation. |
| Flight filters | Class (Economy, First, Business), checked baggage included, direct flights only, and airlines. |
Common mistakeNo more fields appear after choosing the classThe search engine depends on the products contracted and configured on your website. If you don't see the options, contact Pipeline support.
Module
Blog posts NEW
What it's for
Shows boxes with articles from your blog.
When to use it
To link guides and tips from destination pages and improve navigation and SEO.
Dynamic Content Generation×
BLOG POSTS NEWWith this option, we will generate codes (shortcodes) to insert into the page content that will display blog post boxes on the page.
[widget_blog_entradas data-template=1columna]
Select blog posts
1 column
Step by step
- Select the Blog Posts you want to show.
- Choose the Layout: 1 to 6 columns.
- Click Generate and copy the shortcode.
[widget_blog_entradas data-template=1columna]
Common mistakeThe post list appears emptyThere are no published articles yet. Create them in Content › Blog posts.
Module
Flights NEW
What it's for
Shows flight destination boxes and link lists based on a country of origin.
When to use it
On cheap flights pages or on the homepage, for the most searched destinations from your market.
Dynamic Content Generation×
FLIGHTS NEWWith this option, we will generate codes (shortcodes) to insert into the page content that will display flight boxes on the page.
[widget_vuelos data-iso_pais_origen=ES data-box_quant=6 data-display=3 data-permalink_categoria=online data-permalink_pagina=home]
Spain
Select a country
Multiple destinations i2
6
Choose destination countries i
Choose country/ies
10
/online/
/home/
Step by step
- Choose the Origin country. It's mandatory: without it, the shortcode won't be generated.
- Check Multiple destinations to show the most searched ones from that country and choose the number of destinations (3, 4, 6, 8, 9, 12, 15 or 16). Or specify a destination country, or check "Choose destination countries".
- Adjust the Number of list links: 1 to 20 per list. If results of one type are missing, it's filled with the other.
- Choose the Category and the permalink page the links are associated with.
- Click Generate and copy the shortcode.
[widget_vuelos data-iso_pais_origen=ES data-box_quant=6 data-display=3 data-permalink_categoria=online data-permalink_pagina=home]
Common mistakeThe shortcode isn't generatedThe Origin country is missing. The notice "You must select a country of origin to generate the flights shortcode" appears.
Module
Image gallery NEW
What it's for
Inserts a gallery with the images you choose from your files.
When to use it
On destination pages, your own hotels, or group trip stories.
Dynamic Content Generation×
IMAGE GALLERY NEWWith this option, we will generate codes (shortcodes) to insert image galleries into pages.
Step by step
- In Image 1, click the blue folder button and choose the image from your files.
- Click + New image to add more; the red button removes an image.
- Click Generate and copy the shortcode.
TipUse images with the same orientation and a similar size so the gallery looks well organized.
Module
Maps NEW
What it's for
Inserts into the page a map previously created in Content › Maps.
When to use it
To locate offices, routes or points of interest for a destination.
Dynamic Content Generation×
MAPS NEWWith this option, we will generate codes (shortcodes) to insert maps into pages.
[widget_mapas data-container=true data-visualizar-btn=true data-height=400]
400
Load on button clickContainer3
Step by step
- Choose the map in Maps.
- Enter the Height in pixels (for example, 400).
- Optional: Load on button click makes the map load only when the visitor requests it.
- Click Generate and copy the shortcode.
[widget_mapas data-container=true data-visualizar-btn=true data-height=400]
Common mistakeThe map list is emptyYou must first create the map in Content › Maps.
Module
Carousel NEW
What it's for
Inserts an image slider created in Content › Carousel.
When to use it
For visual campaigns within a page, in addition to the homepage's main carousel.
Dynamic Content Generation×
Carousel NEWWith this option, we will generate codes (shortcodes) to insert image sliders into pages.
[widget_sliders data-id=201]
Homepage (1)
Step by step
- Choose the Slider from the list.
- Click Generate and copy the shortcode.
[widget_sliders data-id=201]
Module
Forms
What it's for
Inserts one of the forms available on your website into the page.
When to use it
At the end of a landing page or a product page, to collect information requests.
Dynamic Content Generation×
FORMSWith this option, we will generate codes (shortcodes) to insert into the page content that will display form boxes on the page.
Step by step
- Choose the form from the dropdown.
- Click Generate and copy the shortcode.
Common mistakeThe dropdown is emptyYour website has no forms configured for this module. Check with Pipeline support.
Module
Video NEW
What it's for
Inserts a video into the page content.
When to use it
For destination videos, product presentations or testimonials published on YouTube or Vimeo.
Dynamic Content Generation×
VIDEO NEWWith this option, we will generate codes (shortcodes) to insert videos into the page content.
[widget_video data-url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3Dabc123]
https://www.youtube.com/watch?v=abc123
Optional: if not specified, it's generated automatically for YouTube/Vimeo
Step by step
- Paste the Video URL (https://…).
- Optional: choose a Thumbnail. If you don't specify one, it's generated automatically for YouTube and Vimeo.
- Click Generate and copy the shortcode. The address appears encoded (with %3A, %2F…): that's normal.
[widget_video data-url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3Dabc123]
Guidance
Best practices
Catalog first
Blocks show what's in Orbis Portal. Check the images, text and categories of your products before inserting them.
Filter with a commercial mindset
Categories and tags let you create themed blocks ("Getaways", "Honeymoons") without duplicating content.
Few, well-chosen items
On the homepage, between 3 and 8 boxes per block. For the full catalog, a dedicated page with filters works better.
Think mobile
Layouts with 4 or more columns look great on desktop. Always check how they look on mobile.
Before publishing
- The shortcode is in its own paragraph, with no text before or after it.
- It's pasted into every language tab you use.
- The filters return results.
- The number of items matches the columns (6 in 3 columns, 8 in 4…).
- You've checked the page with "View page" on desktop and mobile.
Support
Common issues
The shortcode text appears in square brackets on the website.It's incomplete, was edited by hand, or was pasted with formatting. Generate it again, paste it into a clean paragraph and save.
The block appears empty.The filters don't find any published content. Broaden the filter or check the products.
I pasted the shortcode into Content and it does not show on the website.The page has Content on the website set to Web builder, so the website does not show the Content field. Paste the shortcode into a Widget element in the builder, or choose Editor and save the page.
It shows in one language but not another.Content is saved per language. Paste the shortcode into each tab.
I want to change a block that's already published.Generate a new shortcode with the correct options and replace the previous one.
I closed the window without copying the shortcode.Reopen the generator with the green button and click Generate again.
Still not working?Contact Pipeline support and provide the page URL and the shortcode used.