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

# Customer Portal

> Designed for self-service.

## We built a customer portal so you don't have to

Launch a self-service portal for invoices, prices, consumption, and account management without writing a frontend. The portal is themed to your brand, signs customers in with a one-time email code, and ships every new Nomos feature automatically.

```
https://{plan.slug}.customerportal.energy/
```

<Frame caption="Example: a plan with slug lumio is reachable at lumio.customerportal.energy, themed to your organization">
  <img src="https://mintcdn.com/riverslate/rFuRSKXuhnC74OsD/images/hosted-customer-portal.png?fit=max&auto=format&n=rFuRSKXuhnC74OsD&q=85&s=5db0852544eaba6c3c900a2dff5c3fab" alt="Hosted customer portal dashboard with consumption chart, invoices, and account panels" width="2326" height="1298" data-path="images/hosted-customer-portal.png" />
</Frame>

## What customers get

Every section is a real route. There is no feature flag to enable any of it.

* **Dashboard.** Today's and tomorrow's dynamic prices, current consumption, contract status, the next bill at a glance.
* **Invoices.** A paginated list of every invoice on the subscription. Each opens to a detail view with a consumption breakdown and a downloadable PDF.
* **Consumption.** Daily, weekly, and monthly meter data charted against price. Customers without a smart meter can submit a manual reading from the same screen.
* **Tariff overview.** Working price, basic price, grid fees, contract dates, cancellation, meter swap.
* **Account.** Personal details, payment method (SEPA / IBAN), delivery and billing addresses.
* **Product orders.** Smart-meter rollout status and any add-on products the customer has ordered.
* **Help.** A localized help center wired to your support channel.

## Sign-in

The default is a one-time code by email. To drop an already-authenticated customer straight in from your own app, use [portal single sign-on](/guides/magic-link).

<Steps>
  <Step title="Customer visits the portal">
    They open `https://{plan.slug}.customerportal.energy/login`.
  </Step>

  <Step title="Enters their email">
    Nomos checks the email against the customers on your plan and sends a
    six-digit code.
  </Step>

  <Step title="Enters the code">
    They're signed in. The session persists; no password is involved.
  </Step>
</Steps>

## FAQ

<AccordionGroup>
  <Accordion title="Can I deep-link to a specific page?">
    Yes. Append the path to the portal URL (e.g. `https://{plan.slug}
            .customerportal.energy/invoices`). The customer is prompted to sign in if
    needed and lands on the deep-linked page after. [Portal single
    sign-on](/guides/magic-link) accepts a `next` parameter for the same outcome
    when minting from your backend.
  </Accordion>

  <Accordion title="Can customers manage multiple subscriptions in one portal?">
    Yes. If a customer has more than one active subscription, the portal shows a
    switcher in the header.
  </Accordion>

  <Accordion title="Can I A/B test or modify portal copy?">
    Not in the hosted portal. If you need bespoke copy or layout, [build your
    own](/guides/customer-portal) against the API.
  </Accordion>
</AccordionGroup>