Documentation

How clients view shared documents

A document share is a secure web link you send to a client or other recipient so they can open one of your documents in their browser, with no Esqase account needed. Depending on how you set up the link, the recipient can view the document, download it, and even leave comments. This page explains what your clients see when they open a shared link, and how you configure the share so it behaves the way you want.

This is the client-facing side of document sharing. To learn how the shared document itself is created and edited, see The documents workspace and Editing documents (the file editor). For the firm-side configuration screen in full, see Sharing documents.

Before you begin

  • You create and configure share links from the documents area. To create a share link, your role needs update access for documents. If your role does not include that access, you will not see the Share option on a document.
  • A shared link opens a clean, read-only page. Recipients never see your dashboard, your other documents, or any client data beyond the one document you shared.
  • A share link works for two kinds of documents: uploaded files (such as PDFs) and native Esqase documents you wrote in the file editor. Both open the same way for the recipient.
The documents list with a document's "..." row menu open, highlighting the Share item.

What clients see, and how the firm configures it

You share a document from its Share dialog. Two of its tabs reach people outside your firm, and they give the recipient two different experiences:

  • Contacts: you pick one or more of your contacts. Each gets an email with a secure link, and the document opens only after they confirm the email address you shared it with. Use this for anything confidential.
  • Share link: you create a public link and send it yourself. Anyone who has the link can open the document straight away, with no sign-in. Use this for documents that are not sensitive.

On either tab you also choose what the recipient can do (View only, View and download, or View, download, and comment) and when their access ends. The steps are on Sharing documents: see Share with contacts and Share a public link.

Note: For a contact share, Esqase emails the secure link and records that email on the matter's Communications tab when the document belongs to a matter. A public link is never emailed: you copy it and send it however you normally reach the person. A Message you type on the Share link tab shows to the recipient with the document.

Contact shares are listed on the Contacts tab under Shared with contacts, and public links on the Share link tab under Active links, each with its access level and when it was last viewed. You can take access away at any time (see Revoking a link below).

Note: On a document you wrote in the file editor, what the recipient sees in place of each placeholder depends on the kind of share. A contact share shows the values you filled in, with a blank line where a placeholder is still empty, and so does the Esqase Client app when the client opens that share. A public link shows the placeholders as their {{tokens}}. See Sharing documents.

Note: A document you wrote shows as one continuous page: its header once above the text, its footer once below, and every tab in order under its tab name. See What a shared document you wrote shows.

A public link is the simplest experience for your recipient. There is no sign-in, no password, and no waiting on an email.

Here is what your client does:

  1. They click the link you sent. It opens in any modern browser, on a phone, tablet, or computer.
  2. The document loads immediately on a clean viewer page.
  3. At the top of the page they see the document name and a "Shared by [your firm name]" line, so they know the document is from you.
  4. If you granted download access, a Download button appears in the top-right corner. If you granted comment access, a Comments panel appears on the right.

That is the whole flow for a public link: click and read.

A public shared document open in the viewer, highlighting the document title, the "Shared by [firm name]" line, and (if present) the Download button.

Important: Anyone who has a public link can open the document. Only use a public link for documents that are safe to share broadly. For confidential material, share with the contact on the Contacts tab so they must confirm their email first.

Unlocking a restricted share (signing in)

When you share with a contact, the link is restricted to the contact's email address. Before the document opens, the recipient must prove they own that address, and most of the time that happens by itself. The full walkthrough is on How clients sign in; here is what it means for a shared document.

If the recipient is already signed in to Esqase, there is nothing to do. The page shows Signing you in for a moment and then opens the document by itself.

If they are not signed in, the page sends them to their Esqase client portal sign-in panel, which says "Sign in to open your document". They sign in there with a 6-digit code Esqase emails them, or with Continue with Google, and they land back on the document.

The email sign-in link is the fallback, shown on the share page itself when the automatic sign-in is refused or does not apply. The recipient enters the address you shared the document with, sees Check your email, opens the link from their inbox on the same device, and the document opens.

After they get in once, they stay unlocked on that device, so they can refresh or come back without signing in again right away.

The restricted share's email sign-in fallback, with the document name, the line saying the firm sent you a document, the Email field, and the Send me a sign-in link button.

Important: Whichever method the recipient uses, the document opens only for the exact email address you shared it with. Having an Esqase account grants nothing: signing in with any other address is refused. See How clients sign in.

Tip: Tell your recipient to open an emailed sign-in link on the same device and browser where they requested it. The Check your email screen reminds them, and it keeps the unlock tied to that device.

From the Esqase Client app

A client who uses the Esqase Client app opens a restricted share with View, from the document in the app. It opens inside the app, already signed in with the client's account, so there is no sign-in step. Download, when the access level allows it, hands the file to the phone, which opens it or offers to save or share it, and comments work as they do in a browser. If the page cannot be opened in the app, the app says "Open this from your email", and the link in your share email still works. See The Esqase Client app.

Common questions about restricted shares

  • What if they enter the wrong email? Esqase only sends the secure link if the address matches the one you shared the document with, and a sign-in with any other address is refused with "You're signed in to Esqase with a different email address" and the email sign-in form underneath. The recipient can click Use a different email on the confirmation screen and try the correct address. For privacy, the screen does not reveal whether a given address was the right one.
  • What if the sign-in link expires? Secure sign-in links last 30 minutes and work once. If the recipient sees a message that the link is invalid or expired, they request a new one from the sign-in panel and open the fresh link.
  • Does the recipient need an Esqase account? No. The share page's own email sign-in link opens the document with nothing to set up. Being signed in to Esqase is only a convenience for recipients who deal with you often.
  • Can someone create an account to get at a document we did not send them? No. Registration is open, but it grants nothing. The document opens only for the address on the share, and only after that address is confirmed. See How clients sign in.

Shared documents in the client portal

When you share a document from a matter's documents with a client of that matter, it also shows in the client portal and the Esqase Client app, on that matter's Files page. The row reads Shared, and View opens the document.

  • After the share expires the row stays, labelled Expired, with no View button, so the client can see it existed and ask you for a fresh share.
  • A lead's document reaches the contact by email only. Leads have no page in the client portal, so the share does not show there.
  • A public link never shows in the client portal, because it is not addressed to anyone.

See The client portal and The Esqase Client app.

Downloading a shared document (when allowed)

Whether a recipient can save a copy depends on the access level you chose.

  • If you chose View only, there is no Download button. The recipient can read the document on screen but cannot save a copy through the share.
  • If you chose View and download or View, download, and comment, a Download button appears in the top-right corner of the viewer.

Here is what your client does to download:

  1. With the document open, they click Download in the top-right corner.
  2. Esqase prepares a secure, time-limited download and opens the file in a new browser tab, where the browser saves it as usual.
The shared document viewer with the Download button highlighted in the top-right header.

Note: Download links are generated fresh each time and expire shortly after, so a copied browser address will not keep working. The recipient should use the Download button again if they need the file later. Every download is recorded on the document's activity history.

Adding a guest comment (when allowed)

If you grant comment access, your recipient can leave notes on the document without an account. This is handy for collecting client feedback, questions, or approvals in one place.

Comments are only available when you choose the View, download, and comment access level. With any lower level, the Comments panel does not appear.

Here is what your client does to comment:

  1. With the document open, they look at the Comments panel on the right side of the page.
  2. Existing comments appear in the panel. If there are none yet, the panel reads "No comments yet. Be the first to leave one."
  3. They type their note in the Add a comment box at the bottom of the panel.
  4. They click Post comment. The comment appears in the list, and a brief "Comment posted" confirmation shows.

Each comment is labeled with the commenter's name. For a contact share, this is the contact you shared it with; on a public link it shows as a guest.

The shared document with the Comments panel open on the right, highlighting the comment list and the Add a comment box with the Post comment button.

Your firm is told when a client comments. A guest comment sends A client commented on a document to the document's owner, to everyone who has access to it, and to anyone who has already commented on it. Clicking the notification opens the document at that comment, so nobody has to keep checking a shared draft to see whether the client has replied. Each person controls this under Comment on my document in their notification settings. See Notifications.

Tip: Guest comments come back to you on the firm side as part of the document's activity. Comment access is best for review-and-feedback documents (drafts, proposals, agreements under negotiation) where you want the client's input captured against the document itself.

The difference between view, view and download, and view and download and comment access

The Recipient can setting controls exactly what a recipient may do. Each level includes everything in the level above it, so the levels build on each other.

  • View only: the recipient can read the document on screen. No Download button and no Comments panel. Choose this when you want the recipient to see a document but not keep a copy or annotate it.
  • View and download: the recipient can read the document and save a copy using the Download button. No commenting. This is the default for a new link and is a good fit for sharing finalized files (signed agreements, receipts, letters).
  • View, download, and comment: the recipient can read, download, and leave comments in the Comments panel. Choose this for collaborative review where you want the recipient's feedback recorded on the document.
The Recipient can dropdown expanded, showing the three options: View only, View and download, and View, download, and comment.

Access level and audience are independent settings. You can combine any access level with either a public link or a contact share. For example, a public View only link is read-only for anyone, while a contact share with View, download, and comment lets that one confirmed contact do everything.

Important: If you change your mind after sharing, take the access away and share again with the access level you want. A new public link is a different URL, and a contact gets a new email.

You can turn off a share at any time. Once it is off, the link stops working immediately and the recipient can no longer open the document.

  • A contact share: on the Contacts tab, find the contact under Shared with contacts, click the trash icon, and click Remove access.
  • A public link: on the Share link tab, find it under Active links, click the trash icon, and click Revoke link.

Anyone who tries to use the old link is blocked.

Tip: Both lists show when each share was last viewed, and Active links also counts the views, so you can confirm whether a recipient has opened a document before you follow up.

Troubleshooting

  • The recipient says the link does not work. Check that the share has not been removed or expired: contact shares show their expiry under Shared with contacts and public links under Active links. For a public link, check that you copied the full URL. For a contact share, the contact must sign in before the document appears.
  • The recipient does not see a Download button. The share is set to View only. Take the access away and share again with View and download or View, download, and comment.
  • The recipient does not see a Comments panel. Comments require the View, download, and comment access level. Share again at that level if you want them to comment.
  • The recipient signed in but the document did not open. The address they signed in with is not the one on the share. Compare it with the email on their row under Shared with contacts. If the contact's email is wrong, fix it on the contact, remove the access, and share again. If they used an emailed sign-in link, it may also have expired or been opened on a different device, in which case they request a fresh one and open it on the same device.
  • You want to share with more than one person, each confirming separately. Pick every contact on the Contacts tab in one go. Each gets their own email and their own secure link.
  • The client cannot find the document in the client portal. Only documents in a matter's documents, shared with a client of that matter, show on the matter's Files page. A lead's document is shared by email only. See Shared documents in the client portal.