Using Data Sources

Pool Queue’s Data Sources feature allows you to display live information—like events, rosters, or fundraisers—on your public-facing site pages. This makes it easy to build rich, dynamic pages without needing to update them manually.

👤 Who is this for?
This article is for club webmasters editing their site pages using the Page Builder.

---

📍 What Are Data Sources?

A Data Source connects a page to a real-time object in the system, like:

• An Event (e.g. a swim meet or social event)

• A Campaign (e.g. a fundraiser or raffle)

• A Roster or Roster Group (e.g. squad info)

Each data source is assigned a variable name, like Event1 or Campaign1. You can use this name in your page content to insert dynamic values like:

{{Event1.Name}} {{Campaign1.TotalRaised}} {{Roster1.Description}}

---

🧰 How to Add Data Sources

1. In the Page Editor, click the [Data Sources] button at the top of the page.

2. In the modal that appears, click Add Data Source.

3. Choose a Source Type (Event, Roster, Campaign, etc.).

4. Click the folder icon to select a specific item from your system.

5. Assign a Variable Name (e.g. Event1 or MyFundraiser).

6. Close the modal. Your data sources are now connected to the page.

✅ You can add as many as you like.

---

✍️ Using Data in Page Content

You can use data source values anywhere in your page using the {{Variable.Property}} format.

For example:

• {{Event1.Name}} – shows the event’s title

• {{Campaign1.PercentRaised}} – shows the current fundraising percentage

• {{Roster1.Description}} – inserts the full roster description (HTML allowed)

💡 Tip: Some values like Description are HTML blocks, so they will be displayed as formatted in the original source.

---

🔎 Live Preview

When you select a data source, a preview panel appears showing:

• All available properties (like Name, StartDate, Url)

• Current values (based on the selected object)

• Sample usage syntax (e.g. {{Event1.Url}})

This helps you know what you can use and how it will appear.

---

⚠️ Notes & Limitations

• ✳️ Dynamic values are inserted when the page loads on the public site. You won’t see them replaced inside the page editor.

• 🚫 No logic is supported. {{#if}}, loops, or formatting functions are not available.

• ❌ If you delete the event/campaign/etc., the placeholder like {{Event1.Name}} will still show on the page.

---

🧱 Using Templates with Data Sources

Many page blocks in the “Data Sources” category are designed to use connected data sources automatically. These blocks often include:

• Campaign goal progress

• Event callouts or banners

• Roster group highlights

You can drop in these blocks and edit their appearance while the data values remain dynamic.

To use them:

1. In the page editor, click [+ Add Block].

2. Select the Data Sources category.

3. Choose a block that matches the type of data you want to show (e.g., a fundraising progress bar or event banner).

4. Make sure your page includes the matching data source (e.g. Campaign1).

5. The page will render real values when published, even if you see placeholders like {{Campaign1.Name}} in the editor.

🧠 These templates support events, campaigns, rosters, and roster groups.

⚠️ Live data only appears on the public site. Tokens like {{Roster1.Name}} are not replaced inside the page editor.