# Portals, public pages and signing links

Let customers, applicants and employees in without a full workspace account: portals, public pages and signing links.

Not everyone your module serves works for the company. Customers want to see their project, applicants want to apply, a client wants to sign a quote. The platform gives you three ways to let them in without a full workspace account, from "sign in to your portal" to "click this link and sign".

| Way in | Who it's for | Sign-in? |
|---|---|---|
| **Portal account** | Repeat visitors: clients, dealers, employees checking their own records | Yes, their own password |
| **Public page** | Anyone: a careers page, a request form | No (or optional) |
| **Signing link** | One person, one record: a quote, an agreement, a change order | No |

## Portal accounts and invites

A portal account is a real sign-in for an outside person, with a role that holds **only your module's permissions**. Your module decides who gets one; the platform owns the login, the password and the invite.

1. Your module sets up its portal role, such as *Client Portal*, made of your permissions only.
2. It sends the person an invite link. Your own public page can welcome them, or the platform's standard invite page.
3. They open the link, choose a password, and land in your portal with just that role.

A new invite replaces the old one, and your module can withdraw invites at any time. Module code never sees or sets a password.

> **Creating the outside person's account** from your module is switched on per module by Data Visions. Setting up the portal role and sending or withdrawing invites is open to every module.

## Public pages

A public page is a page of your module served on its own web address, with no workspace session: a careers page, a contact form, a status page.

- Each page gets a link made of a random code, unique to the workspace.
- A Workspace Admin sees every public page in your module's **Module Settings**, on the **Preferences** tab under **Public pages**: **Copy link**, **Embed code** for their website, **Turn off**, and **New link** if an old link should stop working. It also counts visits.
- **The page is public, the data isn't.** Anything the page loads still goes through your module's normal permission checks. A page can also be set to need a login.

## Signing links: view and sign one record, no login

Email someone outside the workspace a link to **one** record. They open it, read it, download the PDF and, if it's a signing link, sign right on it: drawn with a finger or mouse, or typed.

- **One record, one email address, one signature.** Once signed, the link keeps showing the signed copy until it expires.
- **Expires in 7 days** by default (30 at most).
- **Record changed?** Your module cancels the old links, so nobody signs an outdated version. Sending a new signing link for a record cancels the earlier ones too.
- **Every view, signature and download is logged**, with the time and the IP address it came from.
- **You decide what's shown.** Show the customer's copy (their prices, never your costs) and decide what a signature does, like marking the quote accepted.

The email itself goes out through the workspace's mailbox, with wording the workspace can edit. See [Email](article:00b75e30-6ac5-4c87-a12e-af4178a09f87).

## Ask the Module Builder

> *"Add a Send for signature button to quotes. Email the customer a link to view the quote, download the PDF and sign it. When they sign, mark the quote Accepted and notify the salesperson."*

```json
// For developers: module.json
"ui": {
  "public_pages": [
    {"key": "quote_sign", "path": "sign.html", "name": "Sign a quote",
     "description": "Customers view and sign one quote", "requires_login": false}
  ]
}
```

## Good to know

- **A no-login page gets a closer look.** The module check flags it so a reviewer looks at it. See [Publish a module: the module check](article:cfb41dcb-edee-4f32-979c-d0f041eff1f8).
- **Public pages and signing links are included.** Portal accounts are on the platform's list of services that may be metered later.
- **Workspace Admins can switch any public page off**, and a signing link only works while its page is switched on.
- **A portal role holds only your module's permissions,** so a portal user can never wander into the rest of the workspace. See [Users, roles and permissions in your module](article:37bb9977-455b-41cb-b3df-26e2698f5577).


Source: https://datavisions.ai/docs/creators/platform-services/portals-public-pages-and-signing-links
