Documentation

Sharing documents

Sharing lets people outside your firm open one of your documents, without inviting them as a member or emailing a copy as an attachment. Share with a contact, who gets a secure link only they can open, or create a public link that anyone who has it can open. You choose what they can do (view, also download, or also comment) and when their access ends.

This page covers firm-side sharing: how you share with contacts, create public links, and take access away. For what your recipient sees when they open one, see How clients view shared documents.

Note: The Share dialog has three tabs, in this order: Contacts, Members, and Share link, and it opens on Contacts each time. Members gives a colleague access inside Esqase (see Grant, change, and revoke document access). Contacts and Share link, covered on this page, are for people outside your firm.

Note: Inside your firm, a document of a private matter or lead can be shared only with the people on that record. Adding any other member on the Members tab is refused with "Only people on this matter or lead can be given access". See Private matters and leads.

Before you begin

  • You need a document in your firm to share. This can be an uploaded file or a native document you created in the file editor. See The documents workspace.
  • Sharing is part of the documents area, so your role must include access to documents. If your role does not include update access for documents, you will not see the Share action. Firm owners always have access.
  • Sharing with contacts also needs View access for contacts, and the contact needs an email address on file.
  • A "share link" is a private web address that points to a single document. The person can open the document in their browser, with the access level you chose. They never see the rest of your firm's documents.

Note: A shared document opens for the recipient with the same text and formatting as in Esqase. Images and other media added in the file editor display in the shared view too, with the same layout and text wrapping. See Editing documents (the file editor). A document you wrote shows as one continuous page with its header and footer once, and its placeholders depend on the kind of share: see What a shared document you wrote shows and Public versus email-gated links.

Opening the Share dialog

You start every share from the Share dialog. You can open it from a few places, whichever is most convenient.

  1. From the documents list, find the document you want to share (sharing is for files and documents, not folders).
  2. Click the actions menu (the ... button) on that row, then click Share.
  3. Alternatively, while editing a native document in the file editor, click the Share button in the top toolbar (or open the editor menu and choose Share).
  4. You can also open it from an uploaded file's own page, using the Share button in its header.

Note: A PDF that is ready to send for signature (its signers are saved and someone still has to sign) asks first. Share in its header, or in its row's ... menu on the Documents page or a matter's, lead's, or contact's Documents tab, opens Send to signers or share? ("This document is ready to send for signature."). Click Share document to open the Share dialog, or Send to signers to email the signers instead. See Send the request to your signers.

The dialog opens with the document's name in the title, for example Share 'Engagement Letter', and the line "Choose who can open this document. Removing access here does not delete the document." It has three tabs, and it opens on the first one:

  • Contacts: your firm's contacts, each of whom gets a secure link by email. See Share with contacts.
  • Members: colleagues inside your firm.
  • Share link: a public link anyone who has it can open. See Share a public link.

Share with contacts

Use the Contacts tab to share a document with a client or anyone else you keep as a contact. Each contact gets an email with a secure link, and the document opens only after they confirm their email address, so nobody else can use the link.

  1. In the Share dialog, click the Contacts tab.
  2. Under Add contacts, click Search or select contacts and pick one or more contacts. Type to search by name or email.
    • Suggested lists the clients of the matter or lead the document belongs to, primary client first. Contacts lists everyone else.
    • A contact with no email address is greyed out with No email address.
    • A contact who already has an unexpired share of this document is greyed out with Already shared.
  3. Choose what they can do in Recipient can: View only, View and download (the default), or View, download, and comment. See Choosing the access level.
  4. Choose when their access ends in Expires: 7 days, 30 days (the default), 90 days, or No expiry.
  5. Click Share. The button reads Sharing... while Esqase sends the emails.

You see Document shared, or Shared with 2 contacts when you picked more than one. If a contact could not be shared, an error explains why and that contact stays selected so you can try again.

Note: Suggested contacts appear when the document sits in a matter's or lead's documents. A document outside them shows only the Contacts list.

The email your contact gets

Esqase emails each contact the secure link, so you do not copy or send anything yourself. To open the document, the contact confirms the email address you shared it with. See How clients view shared documents.

  • The email says who shared the document and from which firm, in the subject and the heading, for example Jordan Lee at Merritt & Vale LLP shared a document with you, greets the contact by first name, names the document, and has an Open the document button. If your firm accepted the Business Associate Agreement, the document's name is left out; your name and your firm's name still show. See Business associate agreement (BAA).
  • If the document belongs to a matter, the email is recorded on that matter's Communications tab as a read-only Email row, so your team can see that the link went out and when. See Logging communications.
  • A document shared from a matter's documents also shows on that matter's Files page in the client portal and the Esqase Client app. A lead's document reaches the contact by email only. See Shared documents in the client portal.
A matter Communications tab showing a read-only Email row for a document share link that was sent to a recipient.

Shared with contacts

The Shared with contacts list under the form shows everyone you shared the document with. Each row shows:

  • The contact's name and email.
  • Expires on and the date, Expired on and the date once it has passed, or Never expires.
  • Last viewed and when, or Not viewed yet.
  • What they can do, as a badge: View only, View and download, or View, download, and comment.

If nobody has it yet, you see Not shared with any contacts yet.

To give a contact more time after their share expired, share with them again.

Remove a contact's access

  1. On the Contacts tab, find the contact under Shared with contacts.
  2. Click the trash button on their row.
  3. In Remove this contact's access?, click Remove access.

You see Access removed. Their link stops working straight away. You can share with them again at any time.

Note: If you can open the Share dialog but cannot change the document, the Contacts tab is read only. It lists who has access and reads "You can see who has access but cannot share this document."

The Share link tab creates public links. Anyone who has a public link can open the document right away, without signing in, so use it for documents you are comfortable sharing broadly.

  1. In the Share dialog, click the Share link tab.
  2. Under Create a link, choose what the recipient can do in Recipient can. See Choosing the access level.
  3. Choose when the link stops working in Expires. See Setting when a link expires.
  4. Optionally type a Message, a short note shown to the recipient with the document, for example "Please review and let us know if anything looks off."
  5. Read the warning: "Anyone with this link can open the document without signing in. Only share it with people you trust."
  6. Click Create link.

You see Share link created, and a box titled Share this link with your recipient with the new link ready to copy. The link also appears under Active links. Esqase does not email a public link, so copy it and send it yourself. See Copying the share link.

You can create more than one public link for the same document, each with its own access level and expiry, and revoke each one separately.

Important: A public link puts no barrier in front of the document. Anyone who gets the link, whether you sent it to them or it was forwarded, can open it. For confidential client material, share with the contact on the Contacts tab instead, so only that person can open it. Someone who is not a contact yet needs to be added as a contact first.

Choosing the access level

The Recipient can dropdown, on both the Contacts and Share link tabs, sets what the person is allowed to do once they open the document. The choices, from least to most access, are:

  • View only. The recipient can read the document on screen but cannot save a copy.
  • View and download. The recipient can read the document and download a copy to their device. This is the default.
  • View, download, and comment. The recipient can read, download, and leave comments on the document.

Pick the level that matches what you need from the recipient. For a document you only want someone to read, choose View only. If you want feedback, choose View, download, and comment.

Note: The access level belongs to that one share or link. If you share the same document two ways, each keeps its own access level. To change what someone can do, remove their access or revoke the link, then share again at the level you want.

The Recipient can dropdown expanded, showing View only, View and download, and View, download, and comment.

Every share has an expiry, so a link you sent months ago does not sit open forever. The Expires dropdown offers:

ChoiceContacts tabShare link tab
7 days, 30 days, or 90 daysYesYes
Custom date (pick the date in Expiry date)NoYes
No expiry or Never: open until you remove itNo expiryNever

If you do not change it, Expires is 30 days. Once a share's expiry passes, it stops working automatically, the same as if you had revoked it, and Esqase does not warn the recipient beforehand, so plan ahead if you want to send a reminder or share again before the date arrives.

Tip: Choose No expiry or Never deliberately, for access you intend to keep open (for example, a standing link on your website). For anything sent to one person for one purpose, a shorter expiry limits how long the link matters if it is ever forwarded by mistake.

The difference between the two kinds of share comes down to whether the document opens immediately or only after the person proves they own the email address.

Share link (public)Contacts (email-gated)
Who can open itAnyone who has the linkOnly the contact, at the email address you shared it with
Email stepNone, opens straight awayThe contact confirms their email before the document opens
How it reaches themYou copy the link and send itEsqase emails the secure link
Best forBroadly shareable documentsClient-specific or confidential documents
Placeholders in a document you wroteShown as their {{tokens}}Show the values you filled in, with a blank line for an empty one

Note: On a document you wrote in the file editor, a contact share shows the values you filled in for its placeholders, and a placeholder left empty shows as a blank line. A public link shows the placeholders as their {{tokens}} instead. To send someone a public copy with the values in it, download a PDF and share that. See Document placeholders.

Note: Even a public link is private in the sense that it points only to that one document. It does not expose your firm, your other documents, or any client data beyond the shared file. Still, treat a public link like a key: anyone who has it can use it until you revoke it.

What a shared document you wrote shows

A shared link shows a document you wrote in the file editor as one continuous page, not as separate printed pages:

  • Header and footer. The header shows once above the text and the footer once below it. A page number in them reads 1, and a separate first page header or footer is not shown.
  • Tabs. A document with more than one tab shows every tab in order, each under its tab name in a muted line.
  • Placeholders. They follow the kind of link in every tab and in the header and footer, as the table above shows.

To give someone the document exactly as it prints, with the header, footer, and page numbers on every page, download a PDF and share that. See Export a document.

A shared document in the recipient's browser with the firm's letterhead header above the text, two tabs each under its muted tab name, and the footer below.

Right after you create a public link, Esqase shows it ready to copy so you can paste it into an email, a message, or your case notes.

  1. Create the link as described above. The confirmation box titled Share this link with your recipient appears.
  2. The link is shown in a read-only field. Click the copy button next to it (the icon to the right of the link).
  3. The icon briefly changes to a check mark to confirm the link is on your clipboard.
  4. Paste the link wherever you want to send it.
The Share this link with your recipient confirmation box, with the read-only link field and the copy button highlighted.

Every public link you create for the document is listed under Active links at the bottom of the Share link tab. Contact shares are listed on the Contacts tab instead, under Shared with contacts.

Each row reads Anyone with the link and shows:

  • The access level and how many times the link was opened, for example View and download ยท 16 views.
  • Expires on and the date, or Never expires.
  • Last viewed and when, or Not viewed yet.
  • A copy button so you can grab the link again without recreating it. If the full address is no longer available to copy, the button is disabled with "The full link is shown only when you create it."

If there are no public links yet, you see No active links yet.

Revoking a link turns it off immediately. After you revoke, the link stops working and nobody can open the document through it. Revoke a link as soon as it should no longer work, for example after a matter closes or if it was sent to the wrong person.

  1. In the Share dialog, open the Share link tab.
  2. Find the link under Active links.
  3. Click the trash (revoke) button on that row.
  4. In the Revoke this share link? confirmation, read the warning that anyone with the link loses access immediately and that this cannot be undone, then click Revoke link to confirm.
  5. The link is revoked and removed from the Active links list, and you see Share link revoked.

Important: Revoking cannot be undone. The old link will never work again, even if you later create a new one for the same document. If someone still needs access, create a fresh link and send them the new address.

Note: Revoking a share link only switches off that link. It does not delete or change the document itself, and it does not affect contact shares or firm members who have access through the Members tab. To take a contact's access away, see Remove a contact's access.

Note: Every share on a document, contact shares and public links alike, is revoked automatically, all at once, the moment you move that document to Trash. See Trash a document and restore it from Trash.

A share keeps showing the exact version of the file that was current at the moment you created it, even if you later upload a new version over it. If you need a recipient to see your latest changes, revoke the old link or remove the contact's access, then share again; the new share picks up whatever version is current when you create it.

Note: This applies to uploaded files, which are versioned. A native document you wrote in the file editor has no separate version history for sharing purposes, so its share link always reflects the document's current content.

Troubleshooting

  • The contact says the link does not open. The contact must confirm the same email address you shared the document with. Check it on their row under Shared with contacts. If the contact record had the wrong address, fix it on the contact, remove their access, and share again.
  • The link says it has expired, or simply does not open anymore. Check its expiry under Shared with contacts or Active links. Once a share passes its expiry, it stops working the same as a revoked link. Share again if the person still needs access, and choose a longer expiry if this keeps happening sooner than you expect.
  • A contact is greyed out in the picker. No email address means the contact has no email on file: add one to the contact record first. Already shared means they already have an unexpired share of this document.
  • The Share button is greyed out. Pick at least one contact first. If the tab reads "You can see who has access but cannot share this document.", you cannot change this document.
  • The Create link button is greyed out. With Expires set to Custom date, pick the date in Expiry date first.
  • I want to share with someone who is not a contact. Add them as a contact with their email address, then share on the Contacts tab. See Working with contacts.
  • I do not see the Share action. Sharing requires update access for documents. If your role does not include it, ask a firm owner or administrator to share the document or adjust your role. See Roles and permissions.
  • I need to change what a recipient can do. The access level is set when you share and cannot be edited afterwards. Remove the access or revoke the link, then share again at the level you want.