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

# Portal Sign In and Registration

> Help customers sign in to the portal with email and account number, request a one-time code or magic link, register a matching account, and recover from expired portal links.

<Note>
  **Portal login is separate from staff login**
  Customers do not use staff Arcus credentials. Portal access is tied to the customer
  account email, account number, and portal session token.
</Note>

## Request A Sign-In Code

Customers open the portal sign-in page, enter their email address and account number,
then click **Send code**. The account number is usually printed on an
invoice or other customer document from the seller.

<Frame caption={"Portal sign-in verifies the customer by email and account number before sending a one-time code."}>
  <img src="https://mintcdn.com/arcuserp/MrJkb10V6EpIZu0o/images/support/screenshots/customer-portal/customer-portal-login.png?fit=max&auto=format&n=MrJkb10V6EpIZu0o&q=85&s=488c2753b3b59c64fae75c3d36cbebe3" alt="Customer portal sign-in page branded for Example Supply Co. with email address, account number, Send code button, register link, support contact, and magic-link fallback" width="1920" height="1100" data-path="images/support/screenshots/customer-portal/customer-portal-login.png" />
</Frame>

## Enter The Email Code

After the code is requested, the portal asks for the six-digit code sent by email.
Customers can go back, request a new code after the cooldown, or use the magic-link
fallback when available.

<Frame caption={"The code page completes portal sign-in and creates the customer portal session when the code is valid."}>
  <img src="https://mintcdn.com/arcuserp/MrJkb10V6EpIZu0o/images/support/screenshots/customer-portal/customer-portal-login-code.png?fit=max&auto=format&n=MrJkb10V6EpIZu0o&q=85&s=409722193fcaac5db141d0f8c266c706" alt="Customer portal code entry page with success message, six one-time-code fields, Sign in button, resend countdown, register link, and magic-link fallback" width="1920" height="1100" data-path="images/support/screenshots/customer-portal/customer-portal-login-code.png" />
</Frame>

## Register A Portal Account

First-time customers can use **Register your account**. They enter the
same email and account number. If Arcus finds a matching active customer account,
portal access can be enabled and a single-use login link is sent.

<Frame caption={"Registration is based on matching customer email and account number, not staff user invites."}>
  <img src="https://mintcdn.com/arcuserp/MrJkb10V6EpIZu0o/images/support/screenshots/customer-portal/customer-portal-register.png?fit=max&auto=format&n=MrJkb10V6EpIZu0o&q=85&s=2ce60da0ec425d269143a6f31c3ab71f" alt="Customer portal registration page with email address, account number, Send me a login link button, login link, and support contact" width="1920" height="1100" data-path="images/support/screenshots/customer-portal/customer-portal-register.png" />
</Frame>

<Frame caption={"Registration responses are intentionally safe. Customers see a check-email message instead of account lookup details."}>
  <img src="https://mintcdn.com/arcuserp/MrJkb10V6EpIZu0o/images/support/screenshots/customer-portal/customer-portal-register-success.png?fit=max&auto=format&n=MrJkb10V6EpIZu0o&q=85&s=f075424c4e74f885ff31f386e3444130" alt="Customer portal registration success state telling the customer to check email for a login link that expires in 15 minutes" width="1920" height="1100" data-path="images/support/screenshots/customer-portal/customer-portal-register-success.png" />
</Frame>

## Expired Or Used Links

Magic links are short-lived and single-use. If a customer opens an expired, already
used, or invalid link, the portal shows an error and offers a new-link request.

<Frame caption={"Expired link handling should send the customer back through a fresh login or registration request."}>
  <img src="https://mintcdn.com/arcuserp/MrJkb10V6EpIZu0o/images/support/screenshots/customer-portal/customer-portal-verify-expired.png?fit=max&auto=format&n=MrJkb10V6EpIZu0o&q=85&s=13124a40822c649ea6682d91ff811e17" alt="Customer portal verify page showing Link no longer valid error, Request a new link button, and Register your account link" width="1920" height="1100" data-path="images/support/screenshots/customer-portal/customer-portal-verify-expired.png" />
</Frame>

<Warning>
  **Do not send customers to staff user management**
  Customer portal registration is not the same as inviting a staff user. Staff invites,
  roles, MFA, and organization memberships belong to the internal Arcus app.
</Warning>

## What Happens After Sign-In

* **Valid code or link**: the portal stores a customer portal session in the browser and opens the customer dashboard.
* **Logout**: clears the local portal session and best-effort closes the backend session.
* **Expired session**: the customer must request a new code or link.
* **Wrong account number**: the customer should check the number on their invoice or contact the seller.

<Tip>
  **Use public links when login is unnecessary**
  If the customer only needs one order, payment, quote approval, tracking page, or RMA
  request, a public token link may be simpler than full portal registration.
</Tip>

## Staff Checklist

1. Confirm the customer portal is enabled for the entity.
2. Confirm the customer account allows portal access.
3. Confirm the customer's email address and account number are correct.
4. Confirm email delivery before assuming the portal login flow is broken.
5. Use customer-safe public links for one-off access when full portal login is not needed.

## Common Blocks

* **No code arrives**: check email address, spam filtering, email delivery, and whether the account is portal-enabled.
* **Invalid code**: use the latest email and request a new code after the cooldown if needed.
* **Expired link**: request a new login link or sign in with a code.
* **Registration says check email but no portal appears**: the response is safe by design. Confirm the email and account number match an active customer account.
* **Customer tries staff login**: send the customer portal URL or a public customer link instead.

## Related Articles

<CardGroup cols={2}>
  <Card title="Customer Portal Overview" href="/support/customer-portal/overview">
    Understand portal login, dashboard, customer navigation, setup requirements, and account-scoped visibility.
  </Card>

  <Card title="Portal Profile and Addresses" href="/support/customer-portal/profile-addresses">
    Help customers review portal profile fields, manage addresses, and understand what requires staff help.
  </Card>

  <Card title="Portal Documents and Email Preferences" href="/support/customer-portal/documents-preferences">
    Help customers download visible documents and manage optional email preferences from the portal.
  </Card>

  <Card title="Portal Email Preference Links and Unsubscribe" href="/support/customer-portal/email-preferences-unsubscribe">
    Explain token-based email preference links, unsubscribe choices, re-subscribe, and transactional email limits.
  </Card>

  <Card title="Public Order, Payment, and Quote Links" href="/support/customer-portal/public-links">
    Use tokenized public links for customer order view, payment, shipment tracking, and quote approval.
  </Card>

  <Card title="Portal Quotes and Quote Approval" href="/support/customer-portal/quotes-approval">
    Help customers review portal quote history, open quote detail, and approve eligible quotes safely.
  </Card>
</CardGroup>
