MyJackfruit

Help
Browse topics · Working together

Working together

← Back to How do I create another vault?

How do I share a vault with a person?

Short answer

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

Words used here (4)
GilbApp
GilbApp is the app, opened in a web browser at https://gilb.com/app, where you open, fill and share your vaults.
vault name
A vault name is the short name your vault is known by on GilbPlatform: small letters and digits, the first part of its address.
record
A record is one piece of data with its own address, such as a person, a place, a thing or a note.
project
A project is work to bring about a change you want, such as a new app or a better way of doing something.
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.

    GilbApp with the "GO TO" panel open, and "Vaults" under "YOUR SECTIONS" outlined in orange.
    GilbApp with the "GO TO" panel open, and "Vaults" under "YOUR SECTIONS" outlined in orange.
    Show as text

    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.

    More about this

    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.

  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.

    The "Your vaults" screen with the vaults as cards, and the panel button at the top right of one card outlined in orange.
    The "Your vaults" screen with the vaults as cards, and the panel button at the top right of one card outlined in orange.
    Show as text

    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.

    More about this

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

  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.

    The vault's pane scrolled to "OTHER PEOPLE AND GROUPS ACCESS RIGHTS", with "▸ GRANT ACCESS" outlined in orange.
    The vault's pane scrolled to "OTHER PEOPLE AND GROUPS ACCESS RIGHTS", with "▸ GRANT ACCESS" outlined in orange.
    Show as text

    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.

    More about this

    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.

  4. Under SHARE WITH, keep Person chosen.

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

    The open "▸ GRANT ACCESS" section, with "Person" under "SHARE WITH" outlined in orange.
    The open "▸ GRANT ACCESS" section, with "Person" under "SHARE WITH" outlined in orange.
    Show as text

    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.

    More about this

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

  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.

    The search box under "SHARE WITH" with the start of a name typed and a result row showing, the box outlined in orange.
    The search box under "SHARE WITH" with the start of a name typed and a result row showing, the box outlined in orange.
    Show as text

    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.

    More about this

    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.

  6. Under ACCESS, choose their access.

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

    The "ACCESS" choices "Read", "Write + Read", "Append" and "Control", with "Read" outlined in orange.
    The "ACCESS" choices "Read", "Write + Read", "Append" and "Control", with "Read" outlined in orange.
    Show as text

    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.

    More about this

    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.

  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.

    The greyed-out "ONWARD REACH" group with "Stops here" and "Passes up hierarchy", outlined in orange.
    The greyed-out "ONWARD REACH" group with "Stops here" and "Passes up hierarchy", outlined in orange.
    Show as text

    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.

    More about this

    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.

  8. Press Grant.

    Press Grant once the search box holds a person.

    The form with a person picked and "Read" chosen, and the "Grant" button outlined in orange.
    The form with a person picked and "Read" chosen, and the "Grant" button outlined in orange.
    Show as text

    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.

    More about this

    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.

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, 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)?

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?

To take access back, press × on that person's label in the list; that has its own answer.

Checked against GilbApp d529620.