Skip to main content

How to Use Program Data Tokens on a Web Page

Data tokens let you drop program details, such as the program name, cost, dates, and locations, into a page. The token fills itself in from the program's settings when the page is viewed. You can build a page once and reuse it year over year without retyping program details.

How to Add a Data Source to a Tile

  1. Sign in to a PlayerFirst website.

  2. Open the page you want to edit, click Edit Page. On a program page, click Edit Tab.

  3. Click the tile you want to add program information to.

  4. In the sidebar, open Tile Settings and click the Data Tokens tab.

  5. Under Data source, choose one:

    • None — the tile has no program information.

    • Current page's program — tokens show details for the program the page is being viewed on. Use this for a program page that you plan to copy or reuse.

    • Single/Multiple Programs — tokens show details for programs you pick with filters. See section 4.

NOTES:

  • Current page's program only works on program pages. On any other page the tokens come out blank.

  • A tile that is split into columns uses one data source for all of its columns. Choose the data source on the tile itself.

How to Insert a Data Token

  1. Click inside the tile's text where you want the token to appear.

  2. In the sidebar's Data Tokens tab, open the Insert Token dropdown and choose a token. You can also use the Data Token dropdown in the editor toolbar.

  3. The token shows in the editor as its name in double braces, for example {{ Program Name }}.

Token

What it shows

Pulled from (in Edit Program)

Program Name

The program's name

Basics tab > Program Name

Program Cost

The program's cost, for example $150.00

Basics tab > Program Cost

Total Program Cost

The cost plus PlayerFirst Platform Fees, as a family would see it at checkout

Basics tab > Total Program Cost (worked out from Program Cost)

Primary Location

The program's primary location

Basics tab > Primary Location (only if Display Primary Location is checked)

Secondary Locations

The program's other locations, separated by commas

Basics tab > Secondary Locations (only if Display Secondary Location(s) is checked)

Logo Image

The program's logo (inserted as an image)

Basics tab > Logo Image

Event Start

The program's start date

Reporting tab > Event Start (only if Display Event Dates is checked)

Event End

The program's end date

Reporting tab > Event End (only if Display Event Dates is checked)

Program Year

The program's year

Basics tab > Program Year

Program Season

The program's season

Reporting tab > Season

All Division Names

The names of the program's divisions, separated by commas

Divisions tab (each division's name; publicly listed divisions only)

NOTES:

  • The tokens only work in a tile with a data source. The Insert Token dropdown and the toolbar Data Token dropdown are turned off until you select a tile that has one.

  • If a tile has tokens but no data source, the sidebar warns you: "This tile has data tokens and no data source. Those tokens are removed on the live page."

How to Style Data Tokens

Text tokens are formatted like the text around them. Select the token and use the editor toolbar to change its heading level, font, size, or color. For example, make Program Name a Heading 2.

NOTE: The Logo Image token is an image, so it's sized and placed like other images, not styled as text.

How to Show Several Programs in One Tile

  1. Select the tile and open Tile Settings > Data Tokens.

  2. Under Data source, choose Single/Multiple Programs.

  3. Use the filters to choose which programs to show. Leave a filter blank to include everything:

    • Start Date and End Date (leave both blank to show all live programs)

    • Event Type

    • Programs (pick specific programs, or leave blank for every match)

    • Categories

    • States

    • Brands (parent brands can show programs from their child brands)

    • Gender (Any, Boys, Girls, or Coed)

    • Season(s)

  4. Towards the bottom of the sidebar, it tells you how many programs match, for example "Repeats for 5 programs."

  5. Insert your tokens into the tile as in section 2.

On the live page, the tile repeats once for each matching program, each filled in with that program's details. If only one program matches, the tile shows once.

NOTES:

  • Only programs that are approved, live, and public (or passcode protected) are included, up to 200. Featured programs come first, then the rest in order of start date.

  • If no programs match the filters, the whole tile is left off the page. This is useful for a block that should only show when a program is in season.

  • A tile inside another tile can have its own data source. Each tile fills in from its own source.

What Visitors See

  • Tokens are filled in when the page is viewed, so a copied or shared program page always shows the program it's viewed on.

  • Visitors see the same program details they see elsewhere on the site. These stay off the page, so the token is blank:

    • Primary Location and Secondary Locations if Display Primary Location or Display Secondary Location is turned off in Edit Program.

    • Event Start and Event End if the program's Display Event Dates is turned off, or if the date is blank.

    • Divisions that aren't publicly listed (for example, passcode-only divisions) in All Division Names.

  • Program Cost and Total Program Cost are blank if the program has no cost.

  • A Logo Image with no logo is left off the page instead of showing a broken image.

  • Dates look like "Oct 13, 2026".

NOTES:

  • In the editor, you always see the token name (for example, {{ Program Name }}), not the filled-in value, so you can edit the layout without worrying about the program.

  • Tokens without a data source, or in a tile whose source is cleared later, are removed from the live page.

Did this answer your question?