Skip to Content
FeaturesItems & Details Pages

Understanding Items vs Details Pages

Your widget has two types of views that work together

Item List

The item list is the main view of your widget. It displays all your records in a browsable format — whether as a list, cards, or table. This is what visitors see first when they load your widget.

Think of it like a directory or catalogue page where visitors can browse and scan through multiple items at once.

Details Page

The details page is a dedicated page for each individual record. When enabled, visitors can click on any item in the list to open its full details on a separate page.

Think of it like clicking on a product in a shop to see its full description, images, and specifications.

Details pages get their own URL, making them shareable and SEO-friendly. For embedded widgets with URL sync enabled, opening a detail page also adds a _slug parameter to the host page URL, enabling deep linking directly to items within an embed.

Managing Pages

You can enable or disable each page independently using the page settings button (cog icon) next to the Items List / Details Page toggle in the Content tab.

  • Items List — enabled by default. Disable to hide the list page from visitors.
  • Details Page — disabled by default. Enable to allow visitors to click through to individual records.

At least one page must be enabled at all times. You cannot disable both.

Disabling the Items List

When you disable the items list page:

  • Visitors who navigate to your root URL will see a “Page Not Available” message
  • Detail pages will not show a back button — visitors can only access individual pages via direct URLs
  • The root URL is removed from your sitemap

This is useful when you want to use your widget as a collection of standalone pages rather than a browsable directory. Combined with password protection, this creates a “private pages” pattern where each page is only accessible to people with the direct link.

Enabling the Details Page

  1. Open the page settings using the cog icon next to the view toggle in the Content tab
  2. Toggle Details Page on
  3. Configure the URL slug column — select which column to use for detail page URLs. Values should be unique to ensure each item has its own URL.

Show Other Items on the details page

Display related or random items at the bottom of detail pages:

  • Section title — customise the heading (e.g., “Related Items”, “More Products”)
  • Number of items — show 1-12 items
  • Filter method:
    • Random — show random items from your data
    • By Column — show items that share the same value in a specific column

Other items will use the same layout your items list is using.

  • Layouts — Choose how your items are displayed (cards, list, table, kanban)
  • Additional Fields — Add extra data fields to your items and details pages
  • Cover Images — Configure how images display on items
  • Buttons — Add call-to-action buttons to items and details pages
  • Password Protection — Restrict access to your widget or details pages
Last updated on