CloudPDF
DocsPricing
Start building

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

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:

QuestionGoes on
NameEverything they add, as its author
Email, Company, Job title, DepartmentTheir 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.