Custom fields
Custom fields are the extra details your chamber keeps that Pilaster doesn't have a place for: a member number, a parking permit, a board liaison, the size of a contact's event T-shirt.
The short version
- Owners and admins add them in Setup → Custom Fields, as member fields or contact fields.
- Member fields show up on a Custom Fields tab when you edit a member, and on the member's page. Contact fields show up in the contact form, and under the contact's name.
- Each field has a type, and what's typed is checked against it.
- Archive a field you don't need any more. It comes off the forms, and every answer is kept.
- Changing a field's type is checked against the answers already saved. If some won't fit, you can migrate instead, and nothing is lost.
Adding a field
Open Setup → Custom Fields and click Add Field beside Member fields or Contact fields. Give it a name, pick a type, and set the type's options. Help text is optional and appears under the name on the form. Turn on Required if the form shouldn't save without it.
Use the arrows beside a field to change the order it appears in on the form. Each kind of record can have up to 50 fields in use at once.
The types
- Text: A short answer on one line, like a member number.
- Paragraph: Several lines, like notes about a parking permit.
- Number: A number, like employees. Whole numbers, or with decimals.
- Dollar amount: Dollars and cents, like an annual budget.
- Date: A day, like a business license expiry.
- Yes or no: A switch: on or off.
- Dropdown: One answer from a list you set.
- Checklist: Any number of answers from a list you set.
- Email address: An address checked to look like one.
- Phone number: A phone number.
- Web address: A link, like their LinkedIn page.
Text and paragraph fields can have a character limit. Number fields can allow decimal places (up to four) and a smallest and largest answer, and so can dollar amounts. Dropdowns and checklists have a list of choices you set. Most types can show an example, greyed out in the empty box.
Filling them in
On a member's page, click Edit and open the Custom Fields tab, or click Edit beside Custom fields in the column on the right. For a contact, the fields are at the bottom of Add Contact and Edit Contact. Anyone who can edit members can fill them in. Anyone who can see members sees the answers.
An answer that doesn't fit its field is turned away with the reason, such as "Employees must be a whole number." A yes-or-no field is always answered: off means no.
Changing a field
Click the gear beside a field. Renaming it, or changing its help text, never touches anyone's answers.
- Renaming a choice renames it on every answer that has it.
- Removing a choice nobody picked removes it. If someone did pick it, it's retired instead: it stays on their answer and comes off the form.
- Tightening a setting, such as a shorter character limit or a smaller largest number, is checked against the answers saved, the same way a change of type is.
Changing a field's type
Before a type changes, every saved answer is checked against the new type, and the editor tells you what it found.
- When every answer fits, the change is saved and the answers are converted. Anything can become Text or Paragraph, a dropdown can become a checklist, and "12" typed as text becomes the number 12.
- When some answers don't fit, the change isn't saved, because those answers would be lost. For example, turning a Text field into a Number when someone typed "about 20". The editor lists the answers that don't fit and why.
Then you have two choices. Fix those answers on each member or contact and try again, or click Migrate to a New Field.
Migrating
Migrating makes the change without losing anything:
- The field is archived just as it is, with every answer.
- A new field with the new type takes its place on the form, with the same name unless you changed it.
- Every answer that fits the new type is copied to the new field.
Answers that didn't fit stay on the archived field, where you can read them and re-enter them by hand. In the archived field's View answers, each answer says whether it was copied.
Archiving
Click the archive button beside a field. It comes off the member or contact form, and every answer is kept.
To see archived answers:
- On a member's page, under Archived fields in the Custom fields box, and at the bottom of the editor's Custom Fields tab.
- For a contact, under Archived fields at the bottom of Edit Contact.
- For everyone at once, open the Archived list under the fields in Setup → Custom Fields and click View answers.
Restore puts an archived field back at the end of the form with all its answers. If a field in use already has the same name, rename that one first. Delete is only for archived fields, and removes the answers with it for good.
What custom fields don't do yet
- They're for your team only. Members don't see them in the member area, and they aren't on your website, its member directory or the website API.
- They aren't columns, filters or a search on the Members list, and they aren't in the import, reports or email audiences.
- The help assistant can't look them up or fill them in.
- Only members and contacts have them, not events, sponsors or prospects.
Who can do what
- Owners and admins add, change, order, archive, restore and delete fields.
- Staff fill them in on members and contacts, and see the fields in Chamber Settings.
- Board members see the answers and the fields, but can't change them.
- Volunteers don't see member records, so they don't see custom fields either.