Skip to main content

Overview

After you have created your roster settings, build the portal order page by adding the FS Roster accelerator’s component to a portal page and pointing it at the Roster_Setting__c record you want that page to display. This page covers adding the component, then the CSS and field tips that make the rendered table look its best. If you have not created your Roster_Setting__c records yet, do that first — see Roster Settings.

Prerequisites

  • The FS Roster accelerator (unmanaged-package-roster-accelerator) is installed in the org. The roster component ships with this package, not with managed Portal.
  • The Roster_Setting__c records exist (see Roster Settings).
  • The Business Unit’s FCORE_PORTAL__Portal_URL__c, FCORE_PORTAL__Portal_Checkout_Page_Path__c, and FS_Portal_Installments_Page_Path__c are set, so the order action links resolve.

How to Add a Roster to a Portal Page

1

Create the portal page

Create the portal page that will host the list, following Creating Portal Site Pages.
2

Add the roster component

On the page in Experience Builder, open Components and drag the RosterManageComponent onto the page.
The Experience Builder Components panel with RosterManageComponent

Dragging the RosterManageComponent onto the page

3

Copy the Roster Setting ID

Open the Roster Settings list, click the Roster Setting record you want this page to display, then copy its record ID from the browser URL.
A Roster Setting record with its record ID in the URL
4

Point the component at the record

Paste the Roster Setting ID into the component’s settings. The table now renders the orders or payments defined by that Roster_Setting__c record.
The RosterManageComponent property panel with the Roster Setting ID field

Pasting the Roster Setting ID into the component

The rendered roster table on the portal order page

The rendered roster on the portal page

Improving the Roster UI

These tips style the roster rendered by the FS Roster accelerator — including the order action links surfaced by FS_Portal_Actions__c. Apply the following CSS styles to your Site via: SetupAll Sites → [YOUR SITE] BuilderThemeEdit CSSUse Overrides

Handling Lookup Fields in a Roster

Adding a lookup field directly to a roster will be displayed as a clickable link. However, clicking the link may result in an error page. To avoid this issue, you can create a formula field that displays only text instead of a link.

Example

  • Lookup Field: AccountId
  • Formula Field (Text Display Only): Account.Name
This ensures that the account name appears as plain text rather than a broken link.

Styling the Roster for Better Spacing

Apply the following CSS styles to your Site via: SetupAll Sites → [YOUR SITE] BuilderThemeEdit CSSUse Overrides
A styled roster table with rounded corners, padding, and a drop shadow

Limitations and Common Pitfalls

  • The component comes from a separate package. RosterManageComponent is part of the FS Roster accelerator. If you cannot find it in the Components list, the accelerator is not installed in the org — install it before configuring the page.
  • A wrong or missing Roster Setting ID shows an empty table. The component renders nothing useful unless the ID you paste matches an existing Roster_Setting__c record. Copy the ID from the record’s URL exactly.
  • Action link columns can render blank. If the order action links (FS_Portal_Actions__c) appear empty, the Business Unit is missing one of its URL fields (FCORE_PORTAL__Portal_URL__c, FCORE_PORTAL__Portal_Checkout_Page_Path__c, FS_Portal_Installments_Page_Path__c). This fails silently — no error is shown.
  • The styles target the FS Roster accelerator’s markup. The CSS selectors above (.cRosterManageComponent, div.cRosterComponent) match the classes the FS Roster accelerator renders. They have no effect if the accelerator is not installed and its component is not on the page.
  • Lookup columns render as links that can break. Adding a lookup field directly to a roster displays it as a clickable link, and clicking it may land on an error page in the portal. Display a text formula field (for example, Account.Name) instead of the raw lookup.
  • CSS overrides are site-wide. The styles are applied through the site’s theme CSS overrides, so they affect every roster on the site, not just the order page. Scope your selectors if you need different styling per page.