---
title: "Passphrase, expiry and questions"
description: "Ask visitors for a passphrase, end a grant on a date, and ask who they are before they read or change anything."
source: "https://www.cloudpdf.com/docs/platform/grants/protect"
---

# Passphrase, expiry and questions

Under **More options**, a grant can ask for a passphrase, end on a date, and ask visitors who they
are. Use any of them, or all three.

![More options: a passphrase, an expiry date, and the questions visitors answer, with Name and Email required](https://www.cloudpdf.com/docs/platform/grant-more.png)

## A passphrase

Visitors type it before the document opens. Send it apart from the link, in another message or out
loud, so the link alone isn't enough.

CloudPDF keeps only a fingerprint of the passphrase, so nobody can read it back, not even you. To
change it, type a new one; to drop it, tick **Remove the passphrase**. Guessing is slow: after 30
wrong tries in a minute from one address, CloudPDF refuses that address until the minute is up.

In code it's `passphrase`, on the grant and in the viewer:

```js
viewer.src = { grant: 'grt_…', passphrase: 'quill-review-2026' };
```

Leave it out, and the viewer asks for it.

## An expiry date

The grant works until the end of that day, in your time zone. Then nobody can open it, through its
link or on any website, and a viewer already open stops within 10 minutes. The list shows it as
**Expired**. Pick a later date to bring it back.

## Questions

Tick **Ask who they are**, and choose what to ask:

| Question                                              | Goes on                                                                               |
| :---------------------------------------------------- | :------------------------------------------------------------------------------------ |
| **Name**                                              | Everything they add, as its author                                                    |
| **Email**, **Company**, **Job title**, **Department** | Their row under [visitors](https://www.cloudpdf.com/docs/platform/grants/visitors.md) |

Each is **Required**, **Optional**, or **Don't ask**. A new grant starts with Name and Email
required.

Ask **Before it opens**, or, when visitors can change the document, **Before their first change**:
then anyone can read, and only someone who adds something answers first.

Say why you ask under **Why you ask**, and link your **Privacy notice**. Both show with the
questions.

A visitor answers once in their browser, and can't change an answer later. Only their name goes
into the document.

## In code

```ts
await cloudpdf.grants.create({
  tenantId,
  docId: proposal.documentId,
  name: 'Client review',
  scope: permissions.comment,
  passphrase: 'quill-review-2026',
  expiresAt: '2026-12-31T23:59:59+01:00',
  visitorIdentity: {
    fields: {
      displayName: 'required',
      email: 'required',
      organization: 'optional',
    },
    ask: 'on-open',
    purpose: 'We reply to every comment.',
    privacyUrl: 'https://www.fernquill.example/privacy',
  },
});
```

`ask` is `'on-open'` or `'before-first-change'`. `expiresAt` is a date and time with its offset, and
`null` removes it.

- [Visitors](https://www.cloudpdf.com/docs/platform/grants/visitors.md) — Who answered, what they changed, and erasing them.
- [Pausing and ending](https://www.cloudpdf.com/docs/platform/grants/ending.md) — Stop a grant for a while, or for good.
