# How do I share a vault with a person?

Checked 2026-11-15 against GilbApp d5296208bbffa2ab70076e6194f5537c4be1ddf7.

In "Vaults", press the vault card's panel button, open "▸ GRANT ACCESS", search and select the person, choose their access, and press "Grant".

## Before you start

You need to be [signed in to GilbApp](http://support.gilb.com/help/how-do-i-sign-in-to-gilbapp) on a computer, with "Control" on the vault and the person's vault name or vault address.

A name finds only people who made themselves findable or made their vault public, or whom you already reach; otherwise ask for their vault address. The pictures show a made-up person on a test site; your screen shows your own name and address.

## Steps

1. Press "Main menu" at the top left and choose "Vaults".

   Press "Main menu", next to your profile picture at the top left, and under "YOUR SECTIONS" choose "Vaults". The button shows the name of the section you are in, such as "Vaults".

   Open GilbApp on a computer. A panel headed "GO TO" opens. A vault is where a person or a group keeps their records; the "Vaults" screen lists your vaults as cards.

   ![GilbApp with the "GO TO" panel open, and "Vaults" under "YOUR SECTIONS" outlined in orange.](http://support.gilb.com/help/media/f27a4448ef08b91b.png)
   What you see: Top left, the "Main menu" button next to your profile picture now reads "Vaults" with an arrow, and the "GO TO" panel is open under it. In the left column, under "YOUR SECTIONS", the first row "Vaults" \("Where your data lives. Open, create and share."\) has the orange outline. Click that row.
2. Press the panel button at the top right of the vault's card.

   On the card of the vault you want to share, press the small square panel button at the card's top right \(hover text "Show vault info"\). The vault's details open in the pane on the right.

   Clicking the card itself only selects it; on a computer it does not open the pane.

   ![The "Your vaults" screen with the vaults as cards, and the panel button at the top right of one card outlined in orange.](http://support.gilb.com/help/media/670cd564f59f9fec.png)
   What you see: On "Your vaults", each vault is a card in the middle, and the right pane says "No vault is selected. Choose one from Vaults." At the top right corner of the card, the small square button \(hover text "Show vault info"\) has the orange outline. Click it to open the vault's details on the right.
3. In that panel, scroll down and open "▸ GRANT ACCESS".

   Below the vault's details find "OTHER PEOPLE AND GROUPS ACCESS RIGHTS" and open "▸ GRANT ACCESS".

   Above it the pane lists who already has access, or says "No one else has access here yet." The first part of "▸ GRANT ACCESS", "PUBLIC" with a "Make public" button, is not needed for one person: it makes the vault readable by anyone, signed in or not, after asking "Anyone on the internet will be able to read this vault and everything in it. Continue?" Leave it alone. "▸ CONNECT AI" further down is for your own AI; you do not need it.

   ![The vault's pane scrolled to "OTHER PEOPLE AND GROUPS ACCESS RIGHTS", with "▸ GRANT ACCESS" outlined in orange.](http://support.gilb.com/help/media/029817d100e99736.png)
   What you see: In the right pane, below "YOUR ACCESS RIGHTS", the heading "OTHER PEOPLE AND GROUPS ACCESS RIGHTS" says "No one else has access here yet." Just under it, the closed fold "▸ GRANT ACCESS" has the orange outline, with "▸ CONNECT AI" below. Click "▸ GRANT ACCESS" to open it.
4. Under "SHARE WITH", keep "Person" chosen.

   Keep "Person" chosen; it is chosen when the section opens.

   Under it the screen says "The person gets this vault in their own vault list."

   ![The open "▸ GRANT ACCESS" section, with "Person" under "SHARE WITH" outlined in orange.](http://support.gilb.com/help/media/8d9cc563c8689df1.png)
   What you see: In the right pane, the open section shows "PUBLIC" with a "Make public" button, then "SHARE WITH" with two buttons. "Person", on the left and already filled in dark, has the orange outline; under it reads "The person gets this vault in their own vault list." Leave "Person" chosen. "Grant" at the foot is still pale.
5. In the search box, search for the person and select them.

   Type at least two letters of their vault name in the box that shows "Search a name, or paste a vault address \(…/vault\)", then select their row.

   "Searching…" shows while GilbApp looks. Each result row shows the vault's name and, under it, a short address line \(the vault address, or a shorter name for it if the vault has one\). Picking a row puts the vault address in the box. Or paste their vault address, the full web address that names their vault: a full https:// address ending in /vault, which a vault's pane shows under "VAULT ID". If the list stays empty \(the screen says nothing\), those letters match no vault you may find, or the person has not made themselves findable by name or made their vault public: paste their vault address instead. Only people's own vaults are offered, not group or project vaults.

   ![The search box under "SHARE WITH" with the start of a name typed and a result row showing, the box outlined in orange.](http://support.gilb.com/help/media/6aa444bd281c89df.png)
   What you see: Under "SHARE WITH", the search box has the orange outline. Before you type it shows "Search a name, or paste a vault address \(…/vault\)". Here the start of a name is typed, and a row drops down under the box with a vault name and its address below it. Type at least two letters of the person's vault name, then click their row.
6. Under "ACCESS", choose their access.

   Choose their access; "Read" is chosen when the section opens.

   The four levels: "Read" lets the person read the vault. "Write + Read" lets them read it and also write to it \(GilbApp grants Read first, then Write\). "Append" lets them add to the vault only, not read or change what is there. "Control" lets them manage who else has access \(grant and take it away\). "Control" gives no "Read" or "Write" by itself, but whoever holds it can take a copy of the whole vault, every record and file, and can give themselves "Read" or "Write".

   ![The "ACCESS" choices "Read", "Write + Read", "Append" and "Control", with "Read" outlined in orange.](http://support.gilb.com/help/media/995acda3f04d8d92.png)
   What you see: The search box under "SHARE WITH" now holds the picked person's address. Below it, under "ACCESS", are four buttons in two rows: "Read" and "Write + Read", then "Append" and "Control". "Read", top left and already chosen, has the orange outline. Click the level you want to give.
7. Leave "ONWARD REACH" as it is.

   Below "ACCESS" the screen shows "ONWARD REACH" with "Stops here" and "Passes up hierarchy". Both are greyed out while "Person" is chosen under "SHARE WITH", and a person-share does not use them.

   Under them the screen says "Pick a vault \(chip or …/vault address\) to set Stops here vs Passes up hierarchy." They work only when "Vault" is chosen, which gives one vault access to another. What each does is in [the answer on giving your AI access](http://support.gilb.com/help/how-do-i-give-my-ai-access-to-a-vault).

   ![The greyed-out "ONWARD REACH" group with "Stops here" and "Passes up hierarchy", outlined in orange.](http://support.gilb.com/help/media/43242777ad86cdac.png)
   What you see: Below the four "ACCESS" buttons, the "ONWARD REACH" group has the orange outline. Its buttons "Stops here" and "Passes up hierarchy" are pale grey, with "Pick a vault \(chip or …/vault address\) to set Stops here vs Passes up hierarchy." under them. With "Person" chosen, do nothing here.
8. Press "Grant".

   Press "Grant" once the search box holds a person.

   The button stays greyed while the search box is empty and reads "Granting…" while it works. When it works, the screen says "Person granted" and the access you chose, and the person appears in the list above the form with a small label for each kind of access they hold; "Write + Read" shows two labels, "Read" and "Write".

   ![The form with a person picked and "Read" chosen, and the "Grant" button outlined in orange.](http://support.gilb.com/help/media/e364388b921627f8.png)
   What you see: Near the bottom of the right pane, under "ONWARD REACH", the wide dark "Grant" button has the orange outline. Above it, the person's address is in the box and "Read" is chosen under "ACCESS". Click "Grant" to give the access.

## Deeper

Also asked:

How do I invite someone? Share a vault with them. They need an account first, so ask them to [sign up at gilb.com/app](http://support.gilb.com/help/how-do-i-sign-up), then grant them access as above. GilbPlatform sends no e-mail about it, so tell them yourself.

How do I share a whole vault with someone? Sharing a vault gives the person the whole vault, at the access you choose. "Read" or "Write" also reaches the vaults made inside it, except an AI vault. To share one record only, see: [How do I share one record \(not the whole vault\)?](http://support.gilb.com/help/how-do-i-share-one-record-not-the-whole-vault)

Does the person get an e-mail when I share with them? No. GilbPlatform sends no e-mail when you share a vault, so tell the person yourself. They get the vault in their own vault list.

What do "principal" and "grantee" mean in the sharing box? The grantee is the person or vault you give access to. A principal is a person's sign-in address, such as https://name.gilb.com/base; the box takes it, a WebID or a vault address.

Can I give access for a limited time only? Not in GilbApp: access lasts until someone with "Control" presses "×" on it. Only an app's server, given access through GilbPlatform's interface for developers, can get an end time.

Only someone who holds "Control" on the vault sees this part of the screen. If it is missing, you do not hold "Control" here.

On a phone or a window narrower than 840 pixels, choosing a vault card opens its details at once, in a sheet from the right. This answer is written for a computer screen.

"Write + Read" gives both. GilbApp grants "Read" first and then "Write". If "Read" is refused, the screen says "Read \(included in Write\) was refused, so no write was attempted" and gives the reason. If "Read" worked but "Write" was refused, it says "Read was granted but Write was refused", gives the reason, and says "the holder has READ only. Retry to complete it." Press "Grant" again to retry.

Sharing a vault with "Read" or "Write" also shares the vaults made inside it, except an AI vault; "Append" and "Control" stay on this vault.

Use "Person" for a person. The "Vault" choice next to it is for one vault to reach another vault, and the screen warns that a person gets no access from it.

If the box holds something that does not start with https://, the screen says "Use a full https:// vault address — e.g. https://name.gilb.com/vault."

If the name search cannot answer, the screen says "Name lookup is unavailable right now" and tells you to paste the person's vault address instead. That message does not mean nobody matched.

A person with no account yet has no vault to share with. Ask them to sign up at gilb.com/app first: you share with a person's vault, not with an e-mail address, and GilbPlatform sends no e-mail about it. See: [Someone invited me. What do I do first?](http://support.gilb.com/help/someone-invited-me-what-do-i-do-first)

To [take access back](http://support.gilb.com/help/how-do-i-take-access-away), press "×" on that person's label in the list; that has its own answer.
