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.
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:
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 |
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#
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.