Skip to main content

Page Builder

Overview​

The Page Builder allows you to display records from any Dataverse table directly on your WordPress site. You can create fully customized pages using the built-in Query Loop block and filter which Dataverse records appear.

With the Page Builder, you can also insert field values from individual records using Twig templates. Field values are dynamically inserted at the time the page is rendered, allowing you to create personalized record pages.

Use this tool when you want to:

  • Publish Dataverse table data on a public page
  • Display records using a selected view
  • Control filtering, pagination, and layout via Gutenberg

Configuring Dataverse Tables​

Before displaying data, you must enable the desired tables within the DataPress settings:

  1. Navigate to DataPress → Manage Tables in your WordPress admin dashboard.
  2. Locate the tables you wish to use and select them.
  3. Choose a specific View for each selected table and save configurations. You can select multiple views for each table.
  4. Once saved, these tables will appear as sub-menus under the DataPress section.
  5. Switch to the specific records tab (e.g., Contact records) to preview the data synchronized from Dataverse. Here you can switch between configured views and display records.

Customize Fields for Individual Records​

You can customize which columns display for records in your page builder. This allows you to control the appearance of individual record pages using Twig templates and field bindings.

Using the Twig Block​

To display specific fields from a record:

  1. Navigate to DataPress → [Table Name] records (e.g., Contact records).
  2. Select a record and click Edit template.
  3. Add or select a Twig block in the editor.
  4. Reference fields using the record's logical name with Twig syntax:
{{ record.firstname }}
{{ record.emailaddress1 }}
note

Important: The template you create applies to all records in the table. Any fields you add via Twig will display the same way for every record across the entire table.

Configuring Twig Processing​

When using Twig in your template, you must choose the appropriate Twig Processing option:

Available options:

  • Page Content and Title — Recommended. Processes Twig expressions in page content and titles.
  • Do not process — Twig code displays as plain text without processing.
  • Entire HTML — Not recommended. Processes Twig in HTML buffers which may cause unexpected behavior.
warning

We do not recommend using Entire HTML because it works with buffers and can produce unpredictable results. Use Page Content and Title or Do not process instead.

Example: Displaying Contact Information​

Here's a practical example of customizing a Contact record template:

  1. Go to DataPress → Contact records.
  2. Select any contact record and click Edit template.
  3. Add a Twig block and enter the following template:
<h2>{{ record.fullname }}</h2>
<p><strong>Email:</strong> {{ record.emailaddress1 }}</p>
<p><strong>Phone:</strong> {{ record.telephone1 }}</p>
  1. Set Twig Processing to Page Content and Title.
  2. Save your changes.

Now all contact record pages will display this template with the same fields for every record.

Building a Page with the Query Loop​

Step 1: Create a New Page​

  1. Go to Pages → Add New.
  2. Insert the Query Loop block into the editor.
  3. Select a predefined pattern or start with a blank layout.

Step 2: Configure the Data Source​

With the Query Loop block selected, open the Block Settings panel on the right:

  • Query Type: Enable the Custom Query toggle.
  • Post Type: Select the corresponding Dataverse table (e.g., Table Name records).
  • Items per page: Adjust this to control how many records are loaded at once.
  • Filters: Click + and select Taxonomies. In the Table Name views field, type the name of your chosen view.
  • Pagination: If the selected view contains many records, add a Pagination block inside or below the Query Loop so all records are accessible.

When you preview the page, all records will be visible. You can click any record to see its field values.

The link for an individual record follows this pattern: https://your-site.com/{table name}/{guid}

Example: https://your-site.com/contact/1a1111df-0de4-ed11-8847-1122489804cd

info

If the individual record links do not match this pattern, go to Settings → Permalinks in the WordPress Admin Area and scroll to Dataverse records base slug. Enter /%table%/%guid%.

Quick Example: Listing Contacts​

To display a list of contacts from Dataverse:

  1. Create a new page and add a Query Loop block.
  2. In the block settings, set the Post Type to Contact (contact) records.
  3. Set Items per page to 20.
  4. Add a Pagination block to the page.
  5. Customize the inner blocks (Title, Excerpt, etc.) to map to your Dataverse fields.
  6. Publish the page to view your live Dataverse records on the frontend.