> ## 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.

# Display Products & Payments in Your Athlete Portal

> Learn how to add products and payment options to your Athlete Portal. Understand platform restrictions and optimize your sales strategy across web and mobile.

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

<img src="https://mintcdn.com/coachiq/MJVdVKu9PlGZ0meB/images/athlete-portal-product-page.png?fit=max&auto=format&n=MJVdVKu9PlGZ0meB&q=85&s=52e6811328cf88fb110293c955d88e70" alt="CoachIQ Athlete Portal Products page displaying memberships and packages" width="2210" height="1370" data-path="images/athlete-portal-product-page.png" />

<Warning>
  **Critical Platform Restriction**: The Products page is **NOT visible** on iOS and Android mobile apps due to Apple App Store and Google Play Store policies. Athletes can only purchase products through your web portal or mobile browser.
</Warning>

## What you'll accomplish

Set up your products page to display memberships, packages, and services for purchase through your web portal. You'll learn how to organize products into sections, manage visibility settings, and understand critical platform limitations that affect how athletes access your payment options.

<img src="https://mintcdn.com/coachiq/MJVdVKu9PlGZ0meB/images/CleanShot2025-09-26at19.44.47.png?fit=max&auto=format&n=MJVdVKu9PlGZ0meB&q=85&s=d3d78ab7f9cbf31684529d9d8fcf4d9b" alt="CoachIQ web portal product cards with pricing and purchase buttons" width="2210" height="1370" data-path="images/CleanShot2025-09-26at19.44.47.png" />

## Platform restrictions you must know

<Tabs>
  <Tab title="⚠️ Mobile Apps">
    **iOS & Android Apps - Products NOT Available**

    Due to App Store policies:

    * Products page is completely hidden
    * No in-app purchases allowed
    * Athletes cannot see or buy products
    * This is NOT a bug - it's a platform requirement

    **Alternative**: Direct athletes to your web portal & website for purchases
  </Tab>

  <Tab title="✅ Web Portal">
    **Web Browser - Full Access**

    Products fully available when athletes access via:

    * Desktop computers
    * Mobile web browsers (Safari, Chrome)
    * Tablet browsers
    * Any web-based access

    **All features work**: Purchase buttons, payment processing, subscriptions
  </Tab>
</Tabs>

## Understanding the Products page

The Products page displays your payment options, memberships, and packages that athletes can purchase to access your services. It functions identically to the Programs page in terms of organization, but focuses on payment products rather than content.

### Overview

* **Purpose**: Payment collection vs. content delivery
* **Access**: Purchase required vs. content access rules
* **Platform availability**: Web-only vs. all platforms
* **Primary action**: Buy button vs. view content

## Before you begin

<Note>
  **Required**:

  * At least one product must exist in [Payments → Products](/payments/product-overview)
  * Stripe account must be connected for payment processing
</Note>

<Info>
  **Products are hidden by default**: Creating a product in [Payments → Products](/payments/product-overview) doesn't automatically make it visible to athletes. You must explicitly add products to this page (or attach them to schedulers/forms) for athletes to discover them. This lets you set up products before you're ready to launch. [Learn more about product visibility →](/payments/product-overview#product-visibility-where-athletes-can-find-products)
</Info>

<img src="https://mintcdn.com/coachiq/MJVdVKu9PlGZ0meB/images/Products-page.png?fit=max&auto=format&n=MJVdVKu9PlGZ0meB&q=85&s=1d0c29be011aa9dadd0370d9e8814a19" alt="CoachIQ Products page listing available products in the admin dashboard" width="2210" height="1370" data-path="images/Products-page.png" />

## Accessing product settings

<Steps>
  <Step title="Navigate to App Builder">
    From your dashboard, select **App** in the left sidebar.

    <img src="https://mintcdn.com/coachiq/6uophUaKoQZZkQV1/images/athelteportal.png?fit=max&auto=format&n=6uophUaKoQZZkQV1&q=85&s=ca2b436fc7766970baa240bf1e2c43da" alt="CoachIQ App Builder sidebar with App selected in left navigation" width="2208" height="1326" data-path="images/athelteportal.png" />
  </Step>

  <Step title="Select Content tab">
    Click on the **Content** tab in the main navigation.

    <img src="https://mintcdn.com/coachiq/sjDHrTBeU-kS6fyQ/images/coachiq-app-builder-content-page-sections.png?fit=max&auto=format&n=sjDHrTBeU-kS6fyQ&q=85&s=ada38c88e436b16edfcb8d1ad80b7830" alt="CoachIQ App Builder Content tab showing page sections" width="2210" height="1370" data-path="images/coachiq-app-builder-content-page-sections.png" />
  </Step>

  <Step title="Choose Products">
    Select **Products** from the content options to access your product configuration page.

    <Frame />
  </Step>
</Steps>

## Activating the Products page

<Steps>
  <Step title="Locate the Active toggle">
    Find the **Active** toggle in the top right corner of the Products page.

    <img src="https://mintcdn.com/coachiq/MJVdVKu9PlGZ0meB/images/Athlete-portal-update-page-update-settings-preivew-page.png?fit=max&auto=format&n=MJVdVKu9PlGZ0meB&q=85&s=47c714d6ff7f01f61b3e53e5bb383e08" alt="CoachIQ Athlete Portal action bar with Update Page and Settings buttons" width="2210" height="1370" data-path="images/Athlete-portal-update-page-update-settings-preivew-page.png" />

    <Frame />
  </Step>

  <Step title="Toggle visibility">
    * **ON**: Products visible in web portal only
    * **OFF**: Products hidden everywhere

    <Info>
      Remember: Even when Active is ON, products remain hidden on iOS/Android apps due to platform restrictions.
    </Info>
  </Step>

  <Step title="Save your changes">
    Click **Update Page** to save the active status.
  </Step>
</Steps>

## Adding products to sections

<Steps>
  <Step title="Click Add Products">
    Within any section, click the **+ Add Products** button.

    <Frame>
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/coachiq/athlete-portal-add-product-add-section.png" alt="Add Products button in section" />
    </Frame>
  </Step>

  <Step title="Select products to display">
    Choose from your available products:

    * Memberships (recurring subscriptions)
    * One-time packages
    * Session bundles
    * Credit packages

    Each product shows:

    * Product name
    * Price
    * Billing frequency (if subscription)
    * Description preview
  </Step>

  <Step title="Confirm selection">
    Click **Save** to add selected products to the section.

    <Check>
      Products appear immediately with pricing and purchase buttons visible (web portal only).
    </Check>
  </Step>
</Steps>

## Creating and organizing sections

Sections help organize your products into logical categories for easier shopping.

### Adding new sections

<Steps>
  <Step title="Click Add Section">
    Click **+ Add Section** at the bottom of your product list.

    <Frame>
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/coachiq/athlete-portal-add-product-add-section.png" alt="Add Section button for products" />
    </Frame>
  </Step>

  <Step title="Name your section">
    Use clear, descriptive names:

    * "Memberships"
    * "Single Group Class"
    * "Training Packages"
    * "Elite Programs"
    * "Beginner Packages"
  </Step>

  <Step title="Add products to section">
    Use **+ Add Products** to populate the new section.
  </Step>
</Steps>

### Section organization best practices

* Place most popular products at the top
* Group by commitment level (monthly, yearly, one-time)
* Separate memberships from individual purchases
* Consider price-point organization (budget to premium)

## Configuring page settings

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

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

    <Frame>
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/coachiq/athleteportal-productpage-SEOsettings-customslug.png" alt="Settings menu for Products page" />
    </Frame>
  </Step>

  <Step title="Rename the page">
    The first field at the top of the Settings panel is the **Page Name** — the display name athletes see as the tab in their portal. Update it to match your branding (e.g., "Shop", "Memberships", "Purchase").
  </Step>

  <Step title="Update the URL slug">
    The **Slug** field controls the URL path for this page (e.g., `/products`, `/memberships`, `/pricing`).
  </Step>

  <Step title="Configure description">
    Add a **Description** for SEO context explaining your offerings.
  </Step>

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

## Working around platform restrictions

Since products don't appear on mobile apps, you need alternative strategies to drive sales.

### Recommended workarounds

<Tabs>
  <Tab title="Direct Link Strategy">
    **Send athletes to web portal**

    1. Share your portal link via SMS/email
    2. Include link in app announcements
    3. Add "Purchase on Website" message in app
    4. Use QR codes at facility
  </Tab>

  <Tab title="Communication Strategy">
    **Educate your athletes**

    * Explain during onboarding
    * Send purchase instructions via Inbox
    * Create a "How to Buy" program
    * Include web links in session confirmations
  </Tab>

  <Tab title="Alternative Sales">
    **Other purchase methods**

    * In-person payments at facility
    * Phone/text orders
    * Email invoicing
    * Direct Stripe payment links
  </Tab>
</Tabs>

## Preview and testing

<Steps>
  <Step title="Click Preview Page">
    Select **Preview Page** to see the athlete view.
  </Step>

  <Step title="Test on web browser">
    Verify display and functionality:

    * Product cards show correctly
    * Prices display accurately
    * Purchase buttons work
    * Sections organized properly
  </Step>

  <Step title="Confirm mobile app behavior">
    Check iOS/Android apps to verify products are properly hidden (expected behavior).
  </Step>
</Steps>

## Publishing changes

<Steps>
  <Step title="Review all settings">
    Double-check sections, products, and pricing.
  </Step>

  <Step title="Click Update Page">
    Click **Update Page** to publish changes.

    <Check>
      Changes apply immediately to web portal. Mobile apps continue to hide products page as required.
    </Check>
  </Step>
</Steps>

## Common questions

<AccordionGroup>
  <Accordion title="Why can't my athletes see products on the mobile app?">
    **This is not a bug.** Apple App Store and Google Play Store policies prohibit in-app purchases that bypass their payment systems. CoachIQ must hide the Products page on mobile apps to comply with these requirements.

    **Solution**: Direct athletes to purchase through:

    * Web browser on their phone
    * Desktop computer
    * Tablet browser
    * Any web-based access
  </Accordion>

  <Accordion title="How do I sell to athletes who only use the app?">
    Best practices:

    1. **Send purchase links** via SMS or email
    2. **Add announcements** in the app directing to web portal
    3. **Include instructions** in your welcome message
    4. **Process payments** in person or over the phone
    5. **Share QR codes** that link to your web products page
  </Accordion>

  <Accordion title="Can I accept payments through the app at all?">
    No direct payment processing is possible within iOS/Android apps. However, you can:

    * Use credits (pre-purchased on web)
    * Book sessions that require payment later
    * Send payment links through in-app messaging
  </Accordion>

  <Accordion title="Will this restriction ever change?">
    This is an App Store/Play Store policy, not a CoachIQ limitation. Unless Apple and Google change their policies, this restriction will remain in place.
  </Accordion>

  <Accordion title="How do I explain this to frustrated athletes?">
    Sample message:
    "To keep our app free and avoid Apple/Google's 30% fees, purchases must be made through our web portal. Visit \[your-portal-url] on any browser to buy memberships and packages. This helps us keep prices lower for you!"
  </Accordion>

  <Accordion title="Do credits purchased on web work in the app?">
    Yes! Once athletes purchase credits through the web portal, they can use them to book sessions within the mobile app. The restriction only applies to the purchase process, not credit usage.
  </Accordion>
</AccordionGroup>

## Troubleshooting

### Products not appearing in selection

* Verify products exist in [Payments → Products](/payments/product-overview)
* Check the product isn't archived (use the status filter dropdown to check)
* Confirm Stripe is properly connected
* Refresh the App Builder page

### Athletes report they can't find products

1. **First question**: Are they using the mobile app?
   * If yes → Direct them to web browser
   * If no → Continue troubleshooting
2. Check Products page Active toggle is ON
3. Verify their account has access
4. Test the web portal link yourself

### Purchase buttons not working (web)

* Verify Stripe integration is active
* Check product configuration in [Payments](/payments/product-overview)
* Ensure product has valid pricing
* Test in incognito/private browser

## Pro tips

<Tip>
  **Mobile purchase funnel**:
  Create a dedicated "How to Purchase" program in your app that includes:

  1. Step-by-step instructions with screenshots
  2. Direct link to web portal
  3. Video walkthrough
  4. FAQ about why app purchases aren't available
</Tip>

<Tip>
  **Pricing page on website**:
  Since products aren't visible in apps, make your website pricing page comprehensive:

  * Detailed product descriptions
  * Comparison tables
  * Clear CTAs to purchase
  * Mobile-optimized design
</Tip>

<Tip>
  **Communication strategy**:

  * Add web portal link to email signature
  * Include in SMS appointment reminders
  * Share during trial session sign-ups
  * Post QR codes at your facility
</Tip>

<Tip>
  **Section naming for web**:
  Since only web users see this, optimize for conversion:

  * "🔥 Most Popular"
  * "Best Value - Save 20%"
  * "New Member Special"
  * "Limited Time Offer"
</Tip>

<Tip>
  **Track your funnel**:
  Monitor where athletes drop off:

  1. App users who don't know about web purchasing
  2. Web visitors who don't complete purchase
  3. Create targeted messages for each group
</Tip>

## Critical reminders

<Warning>
  **Never promise** in-app purchases are "coming soon" - this is a permanent platform restriction, not a temporary limitation.
</Warning>

<Info>
  **Best practice**: Add a permanent message to your app onboarding flow explaining that purchases happen on the web for the best prices and to avoid app store fees.
</Info>

## Related articles

<CardGroup cols={2}>
  <Card title="Creating Products" icon="box" href="/payments/product-builder">
    Build memberships, packages, and one-time products in the Product Builder
  </Card>

  <Card title="Setting Up Stripe" icon="credit-card" href="/payments/connecting-stripe">
    Connect your Stripe account for payment processing
  </Card>

  <Card title="Understanding the Athlete Portal" icon="mobile" href="/athlete-portal/understanding-your-athlete-portal">
    Learn how the Athlete Portal works for coaches and athletes
  </Card>

  <Card title="Paywall Settings" icon="lock" href="/athlete-portal/paywall-settings">
    Restrict page access until athletes purchase a qualifying product
  </Card>

  <Card title="Product Types" icon="box" href="/payments/product-types">
    Understand the different product types available in CoachIQ
  </Card>

  <Card title="Communicating with Athletes" icon="inbox" href="/inbox/inbox-overview">
    Send messages and announcements through your Inbox
  </Card>
</CardGroup>