# How do I add a person as a stakeholder?

Checked 2026-11-15 against GilbApp d5296208bbffa2ab70076e6194f5537c4be1ddf7.

Press "Main menu", choose "Stakeholders", press "＋ New", choose "Create a new Stakeholder on its own", choose "Person", type a name, and press "Create".

## 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 a vault you can write to, such as [your own vault](http://support.gilb.com/help/how-do-i-create-my-first-vault). 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 "Stakeholders".

   Press "Main menu", next to your profile picture at the top left, and under "YOUR SECTIONS" choose "Stakeholders". The button shows the name of the section you are in, such as "Vaults". A stakeholder is a person, group or system that cares whether a Value goes up or down.

   A panel headed "GO TO" opens; "Stakeholders" reads "The people and organisations you deal with." You can also press the "Stakeholders" button on the card of a vault \(the place where a person or a group keeps their records\) in "Vaults". The screen lists your stakeholders and has the views "Grid", "Graph", "Both" and "Card". The list also holds organisations, systems and groups; the "TYPE" column says which are "Person".

   ![GilbApp with the "GO TO" panel open, and "Stakeholders" under "YOUR SECTIONS" outlined in orange.](http://support.gilb.com/help/media/f5efc0226d5c4349.png)
   What you see: The "GO TO" panel is open. In the left column under "YOUR SECTIONS", the outlined row is "Stakeholders", with the line "The people and organisations you deal with." Press it.
2. Press "＋ New".

   Press "＋ New" at the right end of the bar with the views "Grid", "Graph", "Both" and "Card". With no record selected, "New" shows its choices at once.

   If "＋ New" is greyed, hover on it for the reason; one reason is that the vault you are viewing is one you can only read. If a record is selected in the list, the linking choices are on: "Create a new Stakeholder and link it to" that record, and "Link" it "to an existing Stakeholder". Choose the one "on its own" in step 3. The "GO TO" panel also has "New stakeholder" \("Add a person or organisation."\) under "Stakeholders"; it opens the same "New" dialog.

   ![The "Stakeholders" screen with the list of people and organisations and no record selected, with the "＋ New" button at the right end of the view bar outlined in orange.](http://support.gilb.com/help/media/e5e7d340cf13b0e0.png)
   What you see: You are on the "Stakeholders" screen in "Grid" view, with your people and organisations listed and nothing selected. Press the outlined "+ New" button at the top right, at the end of the bar with "Grid", "Graph", "Both" and "Card".
3. Choose "Create a new Stakeholder on its own".

   Under "New", choose "Create a new Stakeholder on its own". The dialog "New Stakeholder" opens.

   The tile says "A new thing, joined to nothing. You can link it later." The other choices do something else: "Create a virtual folder" and "Upload a file". Two tiles are greyed and say "Select a Stakeholder first."; they link a new record to one you have selected, and you do not need them. "Close" at the top of the dialog closes it and makes nothing.

   ![The dialog headed "New" with its choices, two of them greyed, and the tile "Create a new Stakeholder on its own" outlined in orange.](http://support.gilb.com/help/media/208f0f5771be9dc3.png)
   What you see: A window headed "New" shows tiles. The outlined tile at the top left is "Create a new Stakeholder on its own", with the line "A new thing, joined to nothing. You can link it later." Press it. The two greyed tiles say "Select a Stakeholder first."
4. Under "What are you recording?", choose "Person".

   Under "What are you recording?", choose "Person". The list starts on "Organization", so choose "Person" before you type.

   The list shows "Organization", "Person" and "System", and "More types…" opens every other kind of record you can make here. Only "Person" makes a person. A person needs nothing but a name.

   ![The dialog "New Stakeholder" under "What are you recording?", with "Person" outlined in orange.](http://support.gilb.com/help/media/72e7a5015dc92c4a.png)
   What you see: The window is now headed "New Stakeholder". Under "What are you recording?" the rows are "Organization", "Person", "System" and "More types…". Press the outlined row "Person".
5. If "Kind \(optional\)" shows and you want one, choose a kind.

   If a block headed "Kind \(optional\)" shows and you want one, choose a kind in it to say what the person is to you. Skip it if you do not want one.

   The block shows only when "CREATE IN" is your own vault. Its ready kinds come from GilbVeda, the shared list of terms. A chosen kind is marked "✓"; press it again to unchoose it. Where the general tie, associated-with, is offered, it starts ticked, and choosing a more exact kind replaces it. The line under the buttons says "How they relate to this vault, for you only. It gives them no access to anything." "Show my own kinds" lists kinds you made before. The box "A kind of your own…" with "Add" saves a new kind in your vault at once, even if you then close the dialog. None of this is needed.

   ![The dialog "New Stakeholder" with "Person" chosen and the block "Kind optional", with its kind buttons, help line, "Show my own kinds" and the box "A kind of your own…", outlined in orange.](http://support.gilb.com/help/media/89af3cf156e83b4c.png)
   What you see: "Person" is chosen. Below it the outlined block "Kind \(optional\)" holds kind buttons such as "Customer", "Supplier", "Friend" and "Colleague", the line "How they relate to this vault, for you only.", "Show my own kinds" and the box "A kind of your own…". Press a kind if you want one, or leave it.
6. Type the name in "NAME".

   Type the person's name in "NAME". Use the name you would look for in the list later.

   "Create" stays greyed until the box holds a name. Pressing Enter in "NAME" does not create the person: it opens "More person details" and moves you to its first line. After two letters the dialog may list people already in the vault \("Already in this vault — open this one instead of making a new one:"\); pick one to open that card instead of making a second.

   ![The dialog "New Stakeholder" with "Person" chosen, and the empty box under "NAME" outlined in orange.](http://support.gilb.com/help/media/4bddc146a616fb8d.png)
   What you see: In the "New Stakeholder" window, "Person" is chosen. The outlined box is the one under "NAME", reading "Name this Person". Click it and type the person's name.
7. If you want, open "More person details" and type what you know.

   Open "More person details", then type in any line you know. All lines are optional.

   The lines come from GilbVeda, the shared list of terms, so they can change. They are "EMAIL", "FAMILY NAME", "GIVEN NAME", "ONLINE ACCOUNT", "PHONE", "POSTAL ADDRESS", "PROFILE PHOTO" and "WEB ADDRESS"; each is a box you type in. An "ONLINE ACCOUNT" is a name you use on another website or app, and a "WEB ADDRESS" is the address of a web page. You do not need "PENDING EMPLOYMENT ORGANISATION" or "PENDING EMPLOYMENT TITLE"; the screen does not say what they are for, so leave them empty.

   ![The dialog "New Stakeholder" with a made-up name typed under "NAME", and the closed fold "More person details" outlined in orange.](http://support.gilb.com/help/media/2a9fbf913cf10d5a.png)
   What you see: A name is typed under "NAME". Just below it, the outlined fold line is "More person details". Press it if you want to add more, such as an e-mail address or a phone number.
8. Under "CREATE IN", choose the vault if the one shown is not right.

   Look at "CREATE IN" and, if it shows the wrong vault, choose the right one in the list. The list holds the vaults you can write to.

   With one vault you can write to and none you can only read, "CREATE IN" is a plain line, not a list. Vaults you can only read say "read only, you cannot create there" and cannot be chosen. A line by "Create" says "Create in:" and the vault's name, and adds "not the vault you are viewing" when it is another one. Changing the vault can show or hide "Kind \(optional\)".

   ![The dialog "New Stakeholder" scrolled down, with "More person details" open showing its lines, and the vault list under "CREATE IN" outlined in orange.](http://support.gilb.com/help/media/1ed1f5ce5fc37755.png)
   What you see: The window is scrolled down past the open "More person details" boxes, such as "FAMILY NAME", "GIVEN NAME" and "PHONE". The outlined list is under "CREATE IN" and names your vault. Open it and choose another vault only if this one is not right.
9. Press "Create".

   Press "Create" at the foot of the dialog. The dialog closes and the new person is opened.

   "Cancel" closes the dialog and makes nothing. If you chose a vault other than the one you are viewing, the dialog stays open and says the person was made there, "not in the vault you are viewing. It is not drawn here.", with an "Open it" button that opens the person. If a kind could not be kept, the dialog says the person was made and that you can add the kind on the card.

   ![The "New Stakeholder" dialog scrolled to its end, with the "Create" button at the bottom right outlined in orange.](http://support.gilb.com/help/media/a4124f01891ccd53.png)
   What you see: At the bottom right of the "New Stakeholder" window are "Cancel" and the outlined "Create" button; at the bottom left, "Create in:" names the vault. Press "Create" to save the person.

## Deeper

Only a name is needed to add a person. "Create" stays greyed until you type one, and a vault you can write to must be chosen.

This makes a card for the person in the vault you choose, with the name and any details you type. The dialog has no line for what the person wants or what part they play. To say a person has a stake in a record of your plan, search and select them under "Stakeholder" on that record's card.

When you type a name, the dialog may list people already in the vault. Do not rely on it: look in the "Stakeholders" list first \(its search box shows "Search in current filters…"\), so you do not make a second card for the same person.

This answer is written for a computer screen.

Source: GilbApp af0f04ee838a4d55887d2ff1f72edd49a4ff7ca0 \(https://gilb.com/app/version.json, built 2026-11-09, read 2026-11-09\); files this answer rests on unchanged since aa86eba6 \(StakeholderStart.tsx, stakeholderStart.ts, startKinds.ts, ConnectedCreateDialog.tsx, useStakeholderCreate.ts, StakeholderMatches.tsx, VaultTargetSelect.tsx, NewRecordButton.tsx, CreateModeChooser.tsx, gilbAppMenuRows.ts; section-menu 0.2.4 and gilb-stakeholders pins unchanged; kindRelation.ts changed only in how ties are matched unchanged\). gilbAppMenuRows.ts:144-151 \("Stakeholders", its line, "New stakeholder"\); NewRecordButton.tsx:50-57, :75, :85-89; CreateModeChooser.tsx:90, :105-144; ConnectedCreateDialog.tsx:1356-1364, :1425, :1562-1580, :1679, :1723-1740, :1831-1843, :1994, :2050-2091, :2476; StakeholderStart.tsx:29, :100-137, :156-249, :265-302; StakeholderMatches.tsx:34-37; useStakeholderCreate.ts:136-140, :200-211; recordPerson.ts:96-120 \(personBoxes: the person lines are the text fields GilbVeda gives t:Person\); VaultTargetSelect.tsx:83-127; PlanStakeholders.tsx:440, :453. steps 5, 7, 8 \(aa86eba6, same code\): kind buttons with no tie ticked; person lines EMAIL to WEB ADDRESS, no JOB TITLE or claim-slot lines. GilbVeda read 2026-11-09 \(public\): a:jobTitle, a:pendingClaimSlotKey, a:supersededClaimSlotKey are fields of t:Employment, not t:Person; a:pendingEmploymentTitle, a:email, a:phone, a:givenName, a:familyName, a:postalAddress, a:profilePhoto are fields of t:Person; t:Stakeholder, t:Person, t:RelationshipKind, t:AssociatedWith, t:OnlineAccount, t:WebAddress. Kai-Zen.StakeholderTemplate, Agent.Stakeholder.
