Inicio - Documentación - POM Theme - 09 Shortcodes - Choose the right shortcode

Choose the right shortcode

Choose the smallest Page Builder element that directly represents the visitor's task. This keeps settings understandable and avoids unnecessary queries, scripts and nested markup.

Match the goal to an element family

Goal Start with
Structure a section Row, Column, Inner Row, Inner Column
Add editorial content Text Block, Title, Image, Button, Video, Gallery
Reveal or rotate content Accordion, Tabs, Modal, Off-Canvas, Slider, Carousel
Display WordPress content Dynamic content, Listings (Feed), Taxonomy terms list
Build filtering Listings (Feed) plus Faceted Search controls
Add a form A saved POM Form, Login, Registration form or Edit user form
Display maps Advanced map with its marker or route children
Display shop tools A WooCommerce-specific element whose requirement is active

Choose in Page Builder

  1. Edit the page and open Page Builder.
  2. Select Add new element in the intended column.
  3. Search by the visible component name.
  4. Read its settings and complete the content or data source first.
  5. Add styling and responsive behavior only after the element works.
  6. Update the page and verify the public result.

Prefer one capable element

Use Listings (Feed) for a repeated result set instead of duplicating many hand-built cards. Use Dynamic content for a reusable block instead of copying the same layout into several pages. Use the dedicated Button element instead of attaching click behavior to decorative HTML.

Do not replace semantic content with Raw HTML or Script merely to reproduce a component that already exists. Those elements require trusted-author access and make future editing harder.

Check prerequisites

Some elements appear or return useful output only when their integration is available:

  • WooCommerce elements require WooCommerce and, where stated, WooCommerce Bookings.
  • Faceted Search controls require an enabled context.
  • Map elements require the configured Google Maps integration.
  • Summarize with AI creates outbound prompt links to the selected third-party AI services.
  • Saved-form and saved-query selectors require those objects to exist on the current site.

Verification

The chosen element is appropriate when another editor can identify its purpose from the builder canvas, its empty state is understandable, and removing unrelated settings does not change the required outcome.

Related guides