> ## Documentation Index
> Fetch the complete documentation index at: https://help.coachiq.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Managing Schedulers in Your Athlete Portal

> Learn how to add, organize, and customize schedulers in your Athlete Portal so athletes can book sessions directly from their app.

<Info>
  **Where to find this**: Dashboard → App Builder → Schedule tab
</Info>

## What you'll accomplish

Set up and organize your schedulers so athletes can view available sessions and book directly from their mobile app or web portal. You'll learn how to select which schedulers appear, organize them into sections, and customize how they're displayed to your athletes.

## Before you begin

<img src="https://mintcdn.com/coachiq/GyL3BhBsgm6I0QDU/images/schedulerahtleteportal.png?fit=max&auto=format&n=GyL3BhBsgm6I0QDU&q=85&s=3f8d3277b96907c13d7309ab14bff24c" alt="CoachIQ Athlete Portal Schedule page showing available sessions to book" width="2208" height="1326" data-path="images/schedulerahtleteportal.png" />

<Note>
  **Required setup**: You must have at least one scheduler created before adding it to the Athlete Portal. If you haven't created any schedulers yet, go to **Schedule → Schedulers** to set up your first one.
</Note>

## Understanding the Schedule page

The Schedule page in your Athlete Portal is where athletes view and book available sessions. As a coach, you have complete control over:

* Which schedulers athletes can see
* How schedulers are organized into sections
* The titles and descriptions athletes see
* Whether the scheduling feature is available at all

Each scheduler displays its cost (like "1 Credit") which you set when creating the scheduler. This helps athletes understand the booking cost before they select a session.

<img src="https://mintcdn.com/coachiq/lCcqk2TRIA-yIOYQ/images/athletesidesessions.png?fit=max&auto=format&n=lCcqk2TRIA-yIOYQ&q=85&s=41e30b58ef3ab070230f834048878c48" alt="Athlete view of available sessions with credit costs displayed" width="2210" height="1370" data-path="images/athletesidesessions.png" />

## Accessing your Schedule settings

<Steps>
  <Step title="Navigate to App Builder">
    From your dashboard, click **App** in the left navigation menu, then select **Schedule**.
  </Step>

  <Step title="Locate the Schedule page">
    You'll see any existing sections and schedulers already added to your athlete portal.
  </Step>

  <Step title="Activate the Schedule page">
    Toggle the **Active** switch to control whether athletes can see the Schedule page. When off, the entire scheduling section is hidden from athletes.

    <img src="https://mintcdn.com/coachiq/1MsmAZgyOT2OsGTL/images/setpageasactiveathleteportal.png?fit=max&auto=format&n=1MsmAZgyOT2OsGTL&q=85&s=afe51686ec9bc408da9448d50507d662" alt="CoachIQ App Builder Active toggle for the Schedule page" width="2210" height="1370" data-path="images/setpageasactiveathleteportal.png" />

    <Check>
      Always hit update page to ensure the updates go live!
    </Check>
  </Step>
</Steps>

## Adding schedulers to your portal

<Steps>
  <Step title="Click Add Schedule">
    Within any section, click the **+ Add Schedule** button to add a scheduler.

    <img src="https://mintcdn.com/coachiq/GyL3BhBsgm6I0QDU/images/Addschedulertoathleteapp.png?fit=max&auto=format&n=GyL3BhBsgm6I0QDU&q=85&s=55204c0564c88d59c2847b43101999f4" alt="CoachIQ App Builder Add Schedule button for adding schedulers" width="1920" height="1038" data-path="images/Addschedulertoathleteapp.png" />
  </Step>

  <Step title="Select from available schedulers">
    A modal will appear showing all schedulers you've created in the system. Select the scheduler(s) you want to add.

    <img src="https://mintcdn.com/coachiq/GyL3BhBsgm6I0QDU/images/selectschedulertoaddtoathleteportal.png?fit=max&auto=format&n=GyL3BhBsgm6I0QDU&q=85&s=404a859b4cb8ef3b51f0e26232afefbc" alt="CoachIQ scheduler selection modal showing available schedulers to add" width="2201" height="1328" data-path="images/selectschedulertoaddtoathleteportal.png" />

    <Tip>
      You can select multiple schedulers at once or add them one at a time.
    </Tip>
  </Step>

  <Step title="Confirm your selection">
    Click **Add Selected** to add the chosen schedulers to your section. They'll appear immediately with their title, description, and credit cost.
  </Step>
</Steps>

## Creating and organizing sections

Sections help you organize schedulers into logical groups like "Elite Program", "Rising Stars", or by location. Athletes always see sections expanded - they cannot collapse them.

<Steps>
  <Step title="Add a new section">
    Click **+ Add Section** at the bottom of your scheduler list.

    <img src="https://mintcdn.com/coachiq/GyL3BhBsgm6I0QDU/images/AddsectioninschedulerstoAthleteapp.png?fit=max&auto=format&n=GyL3BhBsgm6I0QDU&q=85&s=7c4b7548972f44232cbb0aad37685104" alt="CoachIQ App Builder Add Section button for organizing schedulers" width="2204" height="1330" data-path="images/AddsectioninschedulerstoAthleteapp.png" />
  </Step>

  <Step title="Name your section">
    Enter a clear, descriptive title for the section (e.g., "Beginner Classes", "Advanced Training", "Summer Programs").
  </Step>

  <Step title="Add schedulers to the section">
    Click **+ Add Schedule** within your new section to start adding schedulers.

    <Check>
      Your section is created and ready for schedulers!
    </Check>
  </Step>
</Steps>

## Customizing scheduler display

Each scheduler can have a custom title and description that athletes see, regardless of the scheduler's original name.

<Steps>
  <Step title="Click on a scheduler">
    Select any scheduler in your list to open its editing panel.

    <img src="https://mintcdn.com/coachiq/GyL3BhBsgm6I0QDU/images/Editdescriptionandtitleforschedulersonathleteportal.png?fit=max&auto=format&n=GyL3BhBsgm6I0QDU&q=85&s=06e18353d5d7e2832092125c780fa59e" alt="CoachIQ scheduler edit panel for customizing title and description" width="2190" height="1278" data-path="images/Editdescriptionandtitleforschedulersonathleteportal.png" />
  </Step>

  <Step title="Edit the title">
    Update the scheduler name that athletes will see. Make it clear and action-oriented.
  </Step>

  <Step title="Edit the description">
    Add helpful context about the session type, skill level, or what athletes should expect. Keep it concise but informative.
  </Step>
</Steps>

## Reordering and managing sections

<Steps>
  <Step title="Access section controls">
    Click the dots menu (⋮) next to any section to see management options.

    <img src="https://mintcdn.com/coachiq/GyL3BhBsgm6I0QDU/images/Move&Deletesectionswithinschedulersonathleteportal.png?fit=max&auto=format&n=GyL3BhBsgm6I0QDU&q=85&s=08d9b8189aaf72707d2f552787b217a2" alt="CoachIQ section management menu with move and delete options" width="2202" height="1325" data-path="images/Move&Deletesectionswithinschedulersonathleteportal.png" />
  </Step>

  <Step title="Reorder sections">
    Drag sections up or down to change their display order. Place your most popular or important sections at the top.
  </Step>

  <Step title="Delete sections">
    Select the delete option to remove an entire section and all its schedulers from the athlete view.

    <Warning>
      Deleting a section from the Athlete Portal doesn't delete the actual schedulers - it just removes them from athlete view.
    </Warning>
  </Step>
</Steps>

## Previewing the athlete experience

Always preview your changes to ensure athletes see exactly what you intend.

<Steps>
  <Step title="Click the preview button">
    Select the preview icon in the top toolbar to see the athlete view.

    <img src="https://mintcdn.com/coachiq/GyL3BhBsgm6I0QDU/images/Previewliveschedulerpageinathleteportal.png?fit=max&auto=format&n=GyL3BhBsgm6I0QDU&q=85&s=fcc8eed245bd44fd35356e2162e04a1f" alt="CoachIQ preview of the live Schedule page as athletes see it" width="2202" height="1278" data-path="images/Previewliveschedulerpageinathleteportal.png" />
  </Step>

  <Step title="Review the layout">
    Check that:

    * Sections appear in the correct order
    * Scheduler titles and descriptions are clear
    * Credit costs display correctly
    * The overall organization makes sense for athletes
  </Step>

  <Step title="Test navigation">
    Click through different schedulers to ensure they're properly configured and available for booking.
  </Step>
</Steps>

## Page settings

Use the Settings panel to rename the Schedule tab and update the page URL.

<Steps>
  <Step title="Open the Settings panel">
    Click the **gear icon** in the top right of the Schedule page to open the Settings panel.

    <img src="https://mintcdn.com/coachiq/GyL3BhBsgm6I0QDU/images/settingsshotforschedulersinathleteportal.png?fit=max&auto=format&n=GyL3BhBsgm6I0QDU&q=85&s=1e981645c5f8e20914e1d680b1730b57" alt="CoachIQ Schedule page advanced settings with SEO and sharing options" width="2202" height="1329" data-path="images/settingsshotforschedulersinathleteportal.png" />
  </Step>

  <Step title="Rename the page">
    The first field at the top of the Settings panel is the **page display name** — this is what athletes see as the tab name in their portal. Update it to whatever fits your program (e.g., "Book Training", "Reserve a Spot").
  </Step>

  <Step title="Update the URL slug">
    The **Slug** field controls the URL path for this page (e.g., `/sessions`, `/schedule`). Update it to match your new name if needed.
  </Step>

  <Step title="Configure Page Meta (SEO)">
    Edit the SEO metadata fields (title, keywords, description) that appear when someone shares your schedule page link.
  </Step>

  <Step title="Save changes">
    Click **Update Page** to apply all settings.
  </Step>
</Steps>

## Common questions

<AccordionGroup>
  <Accordion title="Where do I create new schedulers?">
    Schedulers are created in **Schedule → Schedulers** in your main dashboard. The Athlete Portal only controls which existing schedulers are visible to athletes. [Learn how to create schedulers →](/scheduling/creating-your-first-scheduler)
  </Accordion>

  <Accordion title="Why can't my athletes see certain schedulers?">
    Check that:

    1. The Schedule page is set to **Active**
    2. The scheduler is added to a section in the Athlete Portal
    3. The scheduler has available time slots configured
    4. The athlete has the required credits or payment method
  </Accordion>

  <Accordion title="How do credits work with bookings?">
    The credit amount shown (e.g., "1 Credit") is the cost to book that session. Athletes must have sufficient credits in their account to book. Credits are set when creating the scheduler, not in the Athlete Portal.
  </Accordion>

  <Accordion title="Can I show different schedulers to different athlete groups?">
    Currently, all athletes see the same schedulers. To control access, use the scheduler's internal settings for prerequisites or eligibility requirements.
  </Accordion>

  <Accordion title="Do changes appear immediately?">
    Yes! All changes to the Athlete Portal update instantly. There's no draft mode or publish button - athletes see updates as soon as you make them.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<Warning>
  **Schedulers not appearing in selection modal?** Make sure you've created schedulers in **Schedule → Schedulers** first. The Athlete Portal can only display schedulers that already exist in your system.
</Warning>

### Common issues and solutions

**Athletes can't see the Schedule page:**

* Verify the Active toggle is turned on
* Check that at least one scheduler is added
* Ensure athletes are logged into their accounts

**Credit amounts showing incorrectly:**

* Credits are set in the scheduler configuration, not in the Athlete Portal
* Go to **Schedule → Schedulers** to update credit costs

**Sections appearing in wrong order:**

* Use the dots menu (⋮) to drag and reorder sections
* Changes save automatically

**Scheduler descriptions not updating:**

* Click directly on the scheduler to open edit mode
* Make sure to click outside the field to save changes

## Pro tips

<Tip>
  **Organization best practices:**

  * Group schedulers by program level (Beginner, Intermediate, Advanced)
  * Or organize by location if you have multiple facilities
  * Keep section titles short and clear
  * Place your most popular schedulers at the top
</Tip>

<Tip>
  **Writing effective descriptions:**

  * Include skill level requirements
  * Mention any equipment needed
  * Specify age groups if relevant
  * Keep descriptions under 2 sentences
</Tip>

<Tip>
  **Testing your setup:**

  * Always preview after making changes
  * Test with a demo athlete account if possible
  * Check mobile and desktop views
  * Verify credit requirements are clear
</Tip>

## Related articles

* [Creating Your First Scheduler](/scheduling/creating-your-first-scheduler)
* [Setting Credit Prices for Sessions](/scheduling/credit-system-overview)
* [Managing Scheduler Availability](/scheduling/create-your-availability)
* [Understanding the Athlete Portal](/athlete-portal/understanding-your-athlete-portal)
* [Athlete Portal Access Control](/athlete-portal/paywall-settings)
