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

# Setting Up the Subscription Hub

> Place the Subscription Hub and its companion components on a portal page, and configure each subscription product's visibility and management settings.

## Overview

Set up the Subscription Hub by placing its components on your portal pages and configuring each subscription product's visibility and management controls. The hub and its companions are unmanaged **Portal Components** — clone a component before changing its code so a package upgrade does not overwrite your edits.

## Add the Subscription Hub to a Portal Page

<Steps>
  <Step title="Place the hub component">
    On your subscriptions page, drag and drop the **FS Portal - Subscription Hub** component (and, if you want a highlighted card, **FS Portal - Subscription Hub Featured**) onto the page.

    <Frame caption="The Subscription Hub component on a portal page">
      <img src="https://mintcdn.com/fusionspan/PQhCyVfBbt1uWfmh/images/end-user-guides/4872667170/image-20260123-143535.png?fit=max&auto=format&n=PQhCyVfBbt1uWfmh&q=85&s=8d87fd18c357dfc4303c262bb69f82e5" alt="The FS Portal - Subscription Hub component placed on a portal page" width="1853" height="794" data-path="images/end-user-guides/4872667170/image-20260123-143535.png" />
    </Frame>
  </Step>

  <Step title="Set the required Renew and Manage page URLs">
    On the **FS Portal - Subscription Hub** component, set the **Renew Page** (`renewPageUrl`) and **Manage Page** (`managePageUrl`) properties. Point each one at the portal page that hosts the corresponding renew and manage components.

    <Warning>
      Both URLs are required. If you leave them at their default value of `/`, the Manage and Renew links resolve to the site root and silently take the member to the wrong place — no error is shown.
    </Warning>
  </Step>

  <Step title="Add the manage and benefits pages">
    Create a page for managing subscriptions (for example, **Manage Subscription**) and drop the **FS Portal - Manage Subscription**, **FS Portal - Subscription Card**, and **FS Portal - Subscription Benefit Allocation Tile** components onto it. On the **FS Portal - Manage Subscription** component, fill out the paths for **Cancel Subscription** and **Renew Subscription**. On the **FS Portal - Subscription Benefit Allocation Tile**, set **Allocate Contacts URL** to your [Manage Benefits page](/end-user-guides/portal/subscription-hub/manage-benefits-page) and choose a field set for **Add Contact**.

    <Frame caption="The Manage Subscription component properties">
      <img src="https://mintcdn.com/fusionspan/PQhCyVfBbt1uWfmh/images/end-user-guides/4872667170/image-20260123-163703.png?fit=max&auto=format&n=PQhCyVfBbt1uWfmh&q=85&s=df58b62bc0cb0eed55fc6073973471fb" alt="The FS Portal - Manage Subscription component with Cancel and Renew paths set" width="1800" height="447" data-path="images/end-user-guides/4872667170/image-20260123-163703.png" />
    </Frame>

    <Frame caption="The Subscription Benefit Allocation Tile properties">
      <img src="https://mintcdn.com/fusionspan/PQhCyVfBbt1uWfmh/images/end-user-guides/4872667170/image-20260123-165536.png?fit=max&auto=format&n=PQhCyVfBbt1uWfmh&q=85&s=42669681c277786397a8b72fba3dbc29" alt="The FS Portal - Subscription Benefit Allocation Tile with Allocate Contacts URL set" width="1861" height="820" data-path="images/end-user-guides/4872667170/image-20260123-165536.png" />
    </Frame>
  </Step>

  <Step title="Publish">
    Click **Publish** to make your changes live.
  </Step>
</Steps>

## Configure Subscriptions for the Hub

On each subscription `Product2` record, set the visibility and management controls in the Subscription Configuration section.

| Field                                                                | Description                                                                                                                                     |
| -------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| **Subscription Visibility** (`FS_PORTAL_Subscription_Visibility__c`) | Which contact roles can **see** this subscription in the hub. Leave it empty and the subscription is hidden, even from the contact who owns it. |
| **Manage Subscription** (`FS_PORTAL_Manage_Subscription__c`)         | Which contact roles can **manage** this subscription (including its benefit allocations).                                                       |
| Renew X Days Before Expiry                                           | Number of days before the expiration date when renewal becomes available in the hub.                                                            |
| Renew X Days After Expiry                                            | Number of days after the expiration date during which renewal is still possible.                                                                |
| Renew Anytime                                                        | If checked, renewal is available in the hub at all times.                                                                                       |

<Info>
  **Renew X Days Before Expiry** and **Renew X Days After Expiry** can be safely ignored when **Renew Anytime** is checked.
</Info>

## Limitations and Common Pitfalls

* **Empty Subscription Visibility hides a subscription entirely** — even from the contact who owns it. Set `FS_PORTAL_Subscription_Visibility__c` on each subscription product, or it never appears in the hub.
* **The Renew and Manage page URLs are required and default to `/`.** Left at `/`, the hub's Manage and Renew links resolve to the site root with no error — set both to the real pages.
* **Visibility is not management.** A contact who can see a subscription still cannot act on it unless their role is in `FS_PORTAL_Manage_Subscription__c`.
* **Only subscription Purchase Activities appear** (`FCORE_MEM__Is_Subscription__c = TRUE`); non-subscription purchases never show in the hub.