# Team Settings

# Create Team Members

## Summary
This tutorial guides you through adding new team members to your BuilderPal account, either individually or by importing multiple at once. Adding team members is essential for collaborating on projects, assigning roles, and managing permissions effectively within your construction team.

## How-To Video

<iframe width="560" height="315" src="https://www.youtube.com/embed/x35sKE3XkKs?si=6N0rMPD4TNhXZeUf" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>

## Prerequisites
- You must have admin access or appropriate permissions to manage team members.
- Prepare team member details like name, email, phone, and desired roles/groups in advance.

## Steps
1. Navigate to the **Team Members** page in https://app.builderpal.com.

    ![](https://colony-recorder.s3.amazonaws.com/files/2025-09-10/0aa613d5-1ca5-4968-97cf-64bcb94b9c16/stack_animation.webp)

2. Select **Create Team Member** from the dropdown menu.

    ![](https://colony-recorder.s3.amazonaws.com/files/2025-09-10/951b3fde-9a84-43cc-a447-fd8fa7fdf8c5/stack_animation.webp)

3. Fill out the new team member's information, including name, email, and phone.

    ![](https://colony-recorder.s3.amazonaws.com/files/2025-09-10/23d5573d-8549-48d5-bfad-88505107a330/stack_animation.webp)

4. Assign groups and permissions, then click **Save**.

    ![](https://colony-recorder.s3.amazonaws.com/files/2025-09-10/54f8cfcf-7124-4148-853c-3301697a1257/stack_animation.webp)

5. Click **Save** to confirm and add the new team member.

    ![](https://ajeuwbhvhr.cloudimg.io/https://colony-recorder.s3.amazonaws.com/files/2025-09-10/37f30d81-1654-4695-8af5-a5ee86363e53/ascreenshot.jpeg?tl_px=303,0&br_px=1680,769&force_format=jpeg&q=100&width=1120.0&wat=1&wat_opacity=1&wat_gravity=northwest&wat_url=https://colony-recorder.s3.amazonaws.com/images/watermarks/0EA5E9_standard.png&wat_pad=716,16)

6. To import multiple team members, select **Import Team Members** from the dropdown.

    ![](https://ajeuwbhvhr.cloudimg.io/https://colony-recorder.s3.amazonaws.com/files/2025-09-10/11cf747c-ceac-4a36-8d0a-8286a31428a6/File.jpeg?tl_px=303,0&br_px=1680,769&force_format=jpeg&q=100&width=1120.0&wat=1&wat_opacity=1&wat_gravity=northwest&wat_url=https://colony-recorder.s3.amazonaws.com/images/watermarks/0EA5E9_standard.png&wat_pad=1062,-22)

7. Select **Import Team Members** from the dropdown menu.

    ![](https://ajeuwbhvhr.cloudimg.io/https://colony-recorder.s3.amazonaws.com/files/2025-09-10/7b2b8453-ce5e-40d5-b412-83a3fbdb8e99/File.jpeg?tl_px=303,0&br_px=1680,769&force_format=jpeg&q=100&width=1120.0&wat=1&wat_opacity=1&wat_gravity=northwest&wat_url=https://colony-recorder.s3.amazonaws.com/images/watermarks/0EA5E9_standard.png&wat_pad=1022,40)

8. Write a message describing the team members you want to add, or upload a file with their info.

    ![](https://colony-recorder.s3.amazonaws.com/files/2025-09-10/cb81a385-9312-4d74-b291-2b57aeef04d2/File.webp)

9. Optionally, upload a file containing team member details instead of typing a description.

    ![](https://colony-recorder.s3.amazonaws.com/files/2025-09-10/73d89f94-d83a-4f54-b19a-3760388e36e7/stack_animation.webp)

10. Review and assign roles, verify information, then save the imported team members.

    ![](https://colony-recorder.s3.amazonaws.com/files/2025-09-10/47fcd6de-b071-46db-9be7-48ecb9e981d3/stack_animation.webp)

## Confirmation
The new team member(s) appear in the **Team Members** list, with an invitation email sent if applicable, and they can now access assigned projects based on their roles and permissions.

## FAQ
**Q: What if I don't assign a group or permission during creation?**  
A: You can edit the team member's details later from the **Team Members** page to add or adjust groups and permissions.

**Q: Can I import team members without a file?**  
A: Yes, by writing a descriptive message in the import field, BuilderPal will parse the details to pre-fill the information for review.

**Q: Why isn't the new team member receiving an invitation email?**  
A: Ensure the email address is correct and check spam folders; invitations are sent automatically upon saving.

**Q: How do I remove a team member after adding them?**  
A: From the **Team Members** page, select the member and choose the delete or deactivate option, as covered in related articles like Manage Team Member Permissions.

**Q: Are there limits on how many team members I can add?**  
A: No limits on the free plan, but large imports may take longer to process; for bulk additions, use the file upload for efficiency.

## Related Articles
- Manage Team Member Permissions
- Create Groups
- Edit Company Profile
- Manage Contacts
- Time-tracking & Kiosk App Control Center

# Deleting a Team Member

## Summary

<span style="white-space: pre-wrap;">As a team admin in BuilderPal, you can easily remove individual team members from your team. This action revokes their access and removes them from the team roster. Note that BuilderPal does not charge per user—there is no cost associated with team member count. For full team deletion (removing the entire team, not just an individual member), contact support directly </span><support@builderpal.com><span style="white-space: pre-wrap;"> and request a full team deletion, our team will help you with this.</span>

## Prerequisites

- <span style="white-space: pre-wrap;">You must have </span>**Team Admin**<span style="white-space: pre-wrap;"> role or be the primary account holder.</span>
- Ensure you're logged in to the primary account with admin privileges.
- Back up any shared resources or data associated with the member before deletion.

## Steps

1. <span style="white-space: pre-wrap;">Navigate to </span>**Team Office**<span style="white-space: pre-wrap;"> from the main dashboard menu. !</span>
2. <span style="white-space: pre-wrap;">Select </span>**Team Members**<span style="white-space: pre-wrap;"> to view the list of current team members. !</span>
3. Click on the specific member you want to delete to open their profile details. !
4. <span style="white-space: pre-wrap;">Locate the </span>**trash can**<span style="white-space: pre-wrap;"> icon in the member's profile and click it to confirm deletion. !</span>

## Confirmation

<span style="white-space: pre-wrap;">After deletion, the member will be immediately removed from the team list and lose access to shared BuilderPal resources. You can verify this by refreshing the </span>**Team Members**<span style="white-space: pre-wrap;"> page and confirming the user no longer appears.</span>

## FAQ

**What happens to the deleted member's data?**  
Deleted members lose access to team resources, but their personal BuilderPal account remains intact unless they are the primary holder.

**Can I undo a team member deletion?**  
<span style="white-space: pre-wrap;">No, deletions are permanent. To re-add the member, invite them again via the </span>**Team Members**<span style="white-space: pre-wrap;"> add option.</span>

**Who can delete team members?**  
<span style="white-space: pre-wrap;">Only users with </span>**Team Admin**<span style="white-space: pre-wrap;"> role or the primary account holder have this permission.</span>

**How do I delete the entire team?**  
To delete your whole team (not just a single member), email support@builderpal.com from the primary account holder or a team admin account and request full team deletion.

**Does deleting a member affect billing?**  
No, BuilderPal does not charge per user, so team member deletions have no impact on costs.

## Related Articles

- Add a New Team Member
- Manage Team Roles and Permissions
- Invite Collaborators to a Project
- Upgrade Your Team Plan
- Troubleshoot Team Access Issues
- Full Team Deletion Process

##   

# Create Cost Codes & Divisions

## Summary
This tutorial guides you through setting up cost codes and divisions in BuilderPal, essential for organizing financial tracking, budgeting, and time entries in projects. Proper setup ensures accurate cost allocation, reporting, and compliance across your team.

## Prerequisites
- Access to the Company Back Office as an admin or finance role.
- Basic understanding of your company's cost structure.

## Steps
1. **Navigate to the Manage Cost Codes and Divisions page in your team office.**

    ![](https://ajeuwbhvhr.cloudimg.io/https://colony-recorder.s3.amazonaws.com/files/2025-09-11/f72a129f-b688-424b-9168-ee1946ce6669/ascreenshot.jpeg?tl_px=0,0&br_px=1376,769&force_format=jpeg&q=100&width=1120.0&wat=1&wat_opacity=1&wat_gravity=northwest&wat_url=https://colony-recorder.s3.amazonaws.com/images/watermarks/0EA5E9_standard.png&wat_pad=1311,-17)

2. **Click the plus button in the top right corner and select Add Division.**

    ![](https://colony-recorder.s3.amazonaws.com/files/2025-09-11/d59488be-17d2-41fd-beff-e6e52b742a11/stack_animation.webp)

3. **Enter the division code, display name, and description.**

    ![](https://colony-recorder.s3.amazonaws.com/files/2025-09-11/6248e2b6-d147-4adc-8041-7dc86220a9bc/stack_animation.webp)

4. **Click Select a Sector to browse and choose from a pre-loaded list of divisions if needed.**

    ![](https://colony-recorder.s3.amazonaws.com/files/2025-09-11/adacf259-7690-45fd-ac44-b1085ce09ef5/stack_animation.webp)

5. **Click Save to add the division.**

    ![](https://ajeuwbhvhr.cloudimg.io/https://colony-recorder.s3.amazonaws.com/files/2025-09-11/18c97850-a49c-459b-a2f5-2458acdd51a0/ascreenshot.jpeg?tl_px=303,0&br_px=1680,769&force_format=jpeg&q=100&width=1120.0&wat=1&wat_opacity=1&wat_gravity=northwest&wat_url=https://colony-recorder.s3.amazonaws.com/images/watermarks/0EA5E9_standard.png&wat_pad=572,257)

6. **Select Add Cost Code from the plus button dropdown in the top right corner.**

    ![](https://colony-recorder.s3.amazonaws.com/files/2025-09-11/2bb7dde0-1e7d-4342-8f74-139965551b7c/stack_animation.webp)

7. **Enter the cost code details, including code, display name, description, time clockable status, unit type, default quantity, default amount, and associated division.**

    ![](https://colony-recorder.s3.amazonaws.com/files/2025-09-11/0e56c272-2ca9-4b6d-8f5c-d35b6ba2c279/stack_animation.webp)

8. **Click Save to add the cost code.**

    ![](https://ajeuwbhvhr.cloudimg.io/https://colony-recorder.s3.amazonaws.com/files/2025-09-11/30e5d522-26fe-4897-a288-c3b8f057d32e/ascreenshot.jpeg?tl_px=303,0&br_px=1680,769&force_format=jpeg&q=100&width=1120.0&wat=1&wat_opacity=1&wat_gravity=northwest&wat_url=https://colony-recorder.s3.amazonaws.com/images/watermarks/0EA5E9_standard.png&wat_pad=568,187)

9. **Click Import divisions and cost codes as an alternative setup option.**

    ![](https://colony-recorder.s3.amazonaws.com/files/2025-09-11/f9e92b70-9f77-43a1-a8b3-6940921fdef0/stack_animation.webp)

10. **Choose to import custom cost codes or BuilderPal's default set.**

    ![](https://colony-recorder.s3.amazonaws.com/files/2025-09-11/7697ec47-2825-42b2-8a2a-fd70756afca7/stack_animation.webp)

11. **Click Import to complete the setup.**

    ![](https://colony-recorder.s3.amazonaws.com/files/2025-09-11/5332d288-7b11-40b0-8eb3-78122dee7425/stack_animation.webp)

## Confirmation
The new divisions and cost codes appear in the list on the Manage Cost Codes and Divisions page, ready for use in time entries, budgets, and reports.

## FAQ
**Q: Can I edit a cost code after saving it?**  
A: Yes, click the edit icon next to the cost code in the list to update details like description or time clockable status.

**Q: What happens if I import BuilderPal's defaults?**  
A: It populates standard divisions and codes based on common construction categories, which you can customize further.

**Q: Why can't I see the import option?**  
A: Ensure you have admin or finance role access; if not visible, check your permissions in team settings.

**Q: Are cost codes required for time tracking?**  
A: Yes, they help categorize hours accurately for reporting and budgeting in projects.

**Q: How do divisions group cost codes?**  
A: Divisions act as categories (e.g., Electrical), organizing related cost codes for easier management and filtering.

## Related Articles
- Manage Taxes & Fees
- Generate Payroll Report
- Time-tracking & Kiosk App Control Center
- Edit Company Profile
- Create Team Members

# Team Member Import: Quick Guide (CSV, Excel, QuickBooks IIF)

#### What this does
- Quickly add multiple team members from a file.
- Works with CSV/TSV/TAB, Excel, and QuickBooks IIF employee exports.
- Uses headers‑only AI mapping: only your column names are analyzed to auto‑map fields. Your actual names, emails, and phone numbers stay on your device by default.

#### Before you start
- Make sure your file has a header row (the first non‑empty row should be column names like `First Name`, `Last Name`, `Email`).
- Include at least `First Name` and `Last Name`. `Email` is strongly recommended.

#### Supported file types
- CSV (`.csv`)
- TSV/TAB (`.tsv`, `.tab`)
- Excel (`.xlsx`, `.xls`)
- QuickBooks IIF (`.iif`) — Employee section only

---

### Importing Team Members (Step‑by‑Step)

1) Open Team Members → Import
- Go to the Team Members area in the app and click Import.

2) Upload your file
- Choose a `.csv`, `.tsv`, `.xlsx`, `.xls`, or `.iif` file.

3) Review the auto‑mapping
- If a mapping screen appears, confirm that columns like `First Name`, `Last Name`, `Email`, `Phone`, `Employee ID` are correctly matched. Adjust if needed.

4) Check the preview grid
- You’ll see each person in a grid with columns like First, Last, Email, Username, ID, Phone, and Roles.
- New rows are pre‑selected to be saved. You can uncheck any you don’t want to import.

5) Edit or add people
- Use the Edit action to fix a row (names, email, phone, etc.).
- Use Add Team Member to create a row manually if needed.

6) Assign groups/roles (optional)
- Click the people icon in the Roles column to assign groups and roles.

7) Save
- Click Save Team Members. If any row conflicts (for example, `username`, `email`, or `phone` already in use), you’ll see inline warnings. Fix and save again.

---

### What gets imported
- First name and last name
- Email (used to contact the person)
- Phone (digits normalized; one number per person)
- Employee ID (optional)
- Username (auto‑created if missing; see below)
- Groups and roles (optional; you can assign them during review)

Notes:
- The default password is `Password123` if one isn’t provided.
- You can edit any field before saving.

#### How usernames are created
- If `Email` is present: we use the part before `@` (ignoring any `+tag`). Example: `michael+brad@builderpal.com` → `michael`.
- If there’s no email: we derive `first.last`, lowercase and cleaned (e.g., `Brad Marchand` → `brad.marchand`).
- If duplicates appear in the same upload, a number may be appended to keep them unique.

---

### Using QuickBooks IIF (Employee list)

- The importer reads the Employee section: it looks for a header line starting with `!EMP` and then reads the following `EMP` lines.
- Typical IIF columns it recognizes: `EMAIL` (email), `PHONE1`/`PHONE2` (phone), `REFNUM` or `EMPNO` (employee ID), plus `FIRSTNAME` and `LASTNAME`.

Example IIF snippet:
```
!EMP	NAME	REFNUM	EMAIL	PHONE1	FIRSTNAME	LASTNAME
EMP	Brad Marchand	87	michael+brad@builderpal.com	(604) 613-2792	Brad	Marchand
```

Tips for IIF imports:
- Make sure the file includes `!EMP` followed by `EMP` rows.
- Other IIF sections (like `!QBP EMPLOYEE`, `CUSTOMPI`) are ignored.
- If phone or email didn’t map, check the header names (e.g., `EMAIL`, `PHONE1`).

---

### Examples

Example CSV:
```csv
First Name,Last Name,Email,Phone,Employee ID
Brad,Marchand,michael+brad@builderpal.com,604-613-2792,87
```

What you’ll see in the grid (simplified):
```json
{
  "first_name": "Brad",
  "last_name": "Marchand",
  "username": "michael",
  "send_email_to": "michael+brad@builderpal.com",
  "send_sms_to": "6046132792",
  "employee_id": "87",
  "groups": []
}
```

---

### Troubleshooting
- IIF file missing `!EMP`
  - Re‑export your employees from QuickBooks Desktop and ensure the `!EMP` header and `EMP` lines are present.
- Could not detect a consistent delimiter (CSV/TSV)
  - Re‑save as CSV (comma) or TSV (tab). Ensure the first non‑empty row has column names.
- Header row looks empty or wrong
  - Check that your first non‑empty row contains clear headers like `First Name`, `Last Name`, `Email`.
- Multiple email or phone columns
  - The importer uses the first recognizable match.
- Conflicts on save (username/email/phone in use)
  - The row will show a warning. Edit the value or unselect the row and try again.

---

### Privacy at a glance
- Headers‑only by default: we send only your column labels to AI to figure out mapping.
- Your actual names, emails, and phone numbers are processed locally in BuilderPal by default.

---

### Quick checklist
- File type is supported (`.csv`, `.tsv`, `.xlsx`, `.xls`, or `.iif`).
- First non‑empty row has headers.
- Columns include `First Name`, `Last Name`, and ideally `Email` (plus `Phone`, `Employee ID` if you have them).
- For IIF, confirm the file includes `!EMP` and `EMP` rows.
- In the preview grid, review fields, assign roles if needed, and click Save Team Members.

# Contact Import Modal: Quick Guide (CSV, TSV, Excel)

### Contact Import Modal: Quick Guide (CSV, TSV, Excel)

#### What this does
- Quickly add many contacts from a file into BuilderPal.
- Uses headers‑only AI mapping: only your column names are analyzed to auto‑map fields. Your actual contact data stays local by default.
- This modal does not support QuickBooks IIF. Use CSV/TSV/TAB or Excel.

---

### Before you start
- Make sure your file’s first non‑empty row is a header row (e.g., `First Name`, `Last Name`, `Email`).
- Include at least `First Name` and `Last Name`. `Email` or `Phone` is recommended.

#### Supported file types
- CSV (`.csv`)
- TSV/TAB (`.tsv`, `.tab`)
- Delimited text (`.txt`) using comma, tab, semicolon, or pipe
- Excel (`.xlsx`, `.xls`)

Note: IIF is not supported for contacts. Use the Team Member Import for IIF (Employee) files.

---

### How to import (Step‑by‑Step)

1) Open Contacts → Import
- Go to the Contacts area and click Import.

2) Upload your file
- Choose a `.csv`, `.tsv`, `.txt`, `.xlsx`, or `.xls` file.

3) Review auto‑mapping (if shown)
- If a mapping screen appears, confirm the suggested column matches (e.g., `First Name` → `first_name`, `Email` → `emails`). Adjust if needed.

4) Review the preview grid
- Each row shows a contact with fields such as First, Last, Emails, Phones, Company, Title, and Notes.
- Rows are pre‑selected to import. Uncheck any you don’t want to save.

5) Edit or add contacts
- Use Edit to fix a row inline (names, emails, phones, etc.).
- You can also add a new contact manually if needed.

6) Save
- Click Save Contacts. If conflicts occur (for example, `email` or `phone` already in use), you’ll see inline warnings. Fix and save again.

---

### What gets imported
The grid uses these fields per contact:
- `first_name` (string)
- `last_name` (string)
- `nickname` (string, optional)
- `emails` (array of `{ type: string, email: string }`)
- `phones` (array of `{ type: string, phone: string, country_code: string | null }`)
- `company_name` (string, optional)
- `company_position` (string, optional)
- `notes` (string, optional)

Notes:
- Multiple emails/phones are supported via the `emails` and `phones` arrays. If your file has only one, it becomes the first element (type is inferred from the header when possible, e.g., `work`, `mobile`).
- Phone digits may be normalized during processing.

#### Common header names that auto‑map
- Names: `First Name`, `Firstname`, `Given Name` → `first_name`
- Names: `Last Name`, `Surname` → `last_name`
- Nickname: `Nickname`, `Preferred Name` → `nickname`
- Emails: `Email`, `Email Address`, `Work Email`, `Personal Email` → `emails`
- Phones: `Phone`, `Mobile`, `Cell`, `Work Phone`, `Home Phone` → `phones`
- Company: `Company`, `Organization` → `company_name`
- Title: `Title`, `Position`, `Role` → `company_position`
- Notes: `Notes`, `Comments` → `notes`

---

### Examples

Example CSV
```csv
First Name,Last Name,Email,Phone,Company,Title,Notes
Gabe,Dahl,gabe@example.com,(604) 613-2792,Gabe Renovations,Owner,Prefers text
Jane,Doe,jane@xyz.com,604-555-0199,XYZ Inc,Marketing Director,
```

How those rows appear to the importer (simplified)
```json
[
  {
    "first_name": "Gabe",
    "last_name": "Dahl",
    "emails": [ { "type": "work", "email": "gabe@example.com" } ],
    "phones": [ { "type": "work", "phone": "(604) 613-2792", "country_code": null } ],
    "company_name": "Gabe Renovations",
    "company_position": "Owner",
    "nickname": null,
    "notes": "Prefers text"
  },
  {
    "first_name": "Jane",
    "last_name": "Doe",
    "emails": [ { "type": "work", "email": "jane@xyz.com" } ],
    "phones": [ { "type": "work", "phone": "604-555-0199", "country_code": null } ],
    "company_name": "XYZ Inc",
    "company_position": "Marketing Director",
    "nickname": null,
    "notes": ""
  }
]
```

---

### Using the chat in the modal (optional)
- You can type instructions (e.g., “Please load this file and map headers”) and attach your CSV/TSV/Excel. 
- The assistant only analyzes your header row to infer mapping by default; the actual contact values are processed locally.
- You can also paste small lists of contacts in plain text and let the assistant structure them for you.

Tip: The modal includes quick actions like “Fill Example Text” or “Load Example” to demo the format.

---

### Conflicts and error messages
On Save, you may see conflicts per row. The modal highlights the field and shows a message. Typical keys:
- `email` — email already in use or invalid
- `phone` — phone already in use or invalid
- `contact` — a general contact-level conflict (e.g., duplicate contact)

Unselect or edit conflicted rows and save again.

---

### Troubleshooting
- “Could not detect a consistent delimiter.”
  - Re‑save as CSV (comma) or TSV (tab). Ensure the first non‑empty row contains headers.
- “Header row appears empty or malformed.”
  - Confirm the first non‑empty row is the header row and has at least two columns.
- Email or phone didn’t map.
  - Make sure headers are recognizable (e.g., `Email`, `Phone`, `Mobile`). Adjust mapping if prompted.
- Multiple email or phone columns.
  - The importer will populate the `emails`/`phones` arrays. The first recognizable header becomes the first entry; additional matched headers may be added with inferred `type`.

---

### Privacy at a glance
- Headers‑only AI mapping by default: we send only your column labels to AI to figure out mapping.
- Your actual contact values (names, emails, phone numbers) are handled locally in BuilderPal by default.

---

### Quick checklist
- File type is supported (`.csv`, `.tsv`, `.txt`, `.xlsx`, `.xls`).
- First non‑empty row has clear headers (`First Name`, `Last Name`, `Email`, etc.).
- Columns include at least `First Name` and `Last Name`; ideally `Email` and/or `Phone`.
- Review the preview grid, make edits if needed, then click Save Contacts.
- Remember: IIF files are not supported in this modal.

# Create Groups

## Summary

This tutorial guides you through creating a group in BuilderPal to organize your team members efficiently. Groups enable quick tagging for assignments, communications, and permissions across projects, helping streamline collaboration and task management for larger teams.

## Prerequisites

- Access to the Company Back Office (available to Admins and select team roles).
- At least one team member added to your company.

## Steps

1. **Navigate to the Groups page.** Go to https://app.builderpal.com/company-back-office and select **Groups** from the Team & Company Settings section.

    ![](https://colony-recorder.s3.amazonaws.com/files/2025-09-12/87ff025b-f7e8-47bd-bd30-0f1cfccc5529/stack_animation.webp)

2. **Start creating a group.** Click **Create Group** or the plus icon in the top right corner to open the group setup dialog.

    ![](https://ajeuwbhvhr.cloudimg.io/https://colony-recorder.s3.amazonaws.com/files/2025-09-12/c29559c1-3dcb-4ea1-9e0c-e22c917cb186/File.jpeg?tl_px=0,0&br_px=2602,1454&force_format=jpeg&q=100&width=1120.0&wat=1&wat_opacity=1&wat_gravity=northwest&wat_url=https://colony-recorder.s3.amazonaws.com/images/watermarks/0EA5E9_standard.png&wat_pad=477,83)

3. **Set up group details and add members.** Enter a name and description for the group, then use the search bar to select and add users; click **Save** to confirm.

    ![](https://colony-recorder.s3.amazonaws.com/files/2025-09-12/3d2dfe40-618c-4f60-9862-92a0f3bd9b20/stack_animation.webp)

4. **Review the new group.** Verify the group appears in your list, with members now tagged for easy reference.

    ![](https://colony-recorder.s3.amazonaws.com/files/2025-09-12/ea0525aa-bee6-4aa3-bf4e-e442dcb37be9/stack_animation.webp)

## Confirmation

You can now view your group and group members will receive a tag.

## FAQ

**Q: Who can create groups in BuilderPal?**  
**A:** Admins (GC, SUB, SHORTCUT) and roles like Team Project Manager, Team Finance Manager, and Team Business Manager have access via Company Back Office.

**Q: Can I add users who aren't yet team members?**  
**A:** No, the search bar only shows existing team members; add them first using the Create Team Members workflow.

**Q: What happens if I don't add a description?**  
**A:** The group will still save, but a description helps clarify its purpose for other users viewing the group list.

**Q: How do groups affect permissions?**  
**A:** Groups simplify tagging but don't directly set permissions; manage those separately in Team Member Permissions.

**Q: Can I use groups across projects?**  
**A:** Yes, groups are company-wide and can be tagged in any project for assignments or mentions.

## Related Articles

- Create Team Members
- Team Member Permissions
- Manage Contacts
- Edit Company Profile
- Time-tracking & Kiosk App Control Center

# Edit Team Profile

## Summary
This tutorial guides you through editing your team profile in BuilderPal, including updating company details, adding service areas, uploading images, and showcasing a portfolio. Keeping your profile current helps attract better job matches, improves team visibility, and ensures accurate contact information for collaborations.

## Prerequisites
- You must be logged in to your BuilderPal account at https://app.builderpal.com.
- Have admin or managerial access to the team profile.
- Prepare any images or portfolio items you want to upload in advance.

## Steps
1. **Go to the Company Back Office and click your team profile at the top of the My Team section to open it.**

    ![](https://colony-recorder.s3.amazonaws.com/files/2025-09-12/4194a1e6-2516-435a-a36b-ae27fcd72bc1/stack_animation.webp)

2. **Click Edit in the top right corner, then update your team name, handle, overview, slogan, address, and contact details as needed.**

    ![](https://colony-recorder.s3.amazonaws.com/files/2025-09-12/bbb28399-8b70-4a48-a3b6-6243de771763/stack_animation.webp)

3. **Click Save to apply your changes to the profile details.**

    ![](https://ajeuwbhvhr.cloudimg.io/https://colony-recorder.s3.amazonaws.com/files/2025-09-12/e24f94c1-41b2-4791-ad8c-ec82e47dd199/ascreenshot.jpeg?tl_px=0,0&br_px=1992,1113&force_format=jpeg&q=100&width=1120.0&wat=1&wat_opacity=1&wat_gravity=northwest&wat_url=https://colony-recorder.s3.amazonaws.com/images/watermarks/0EA5E9_standard.png&wat_pad=818,170)

4. **Click Add service areas, then select custom locations or use the recommended list to define your work availability.**

    ![](https://colony-recorder.s3.amazonaws.com/files/2025-09-12/837665e0-347f-4fd4-b8fc-9230c74f31c8/stack_animation.webp)

5. **Click the camera icon on the profile image to upload a new profile picture or team banner from your device.**

    ![](https://colony-recorder.s3.amazonaws.com/files/2025-09-12/8aabceb1-aed8-47c3-9943-abcdb6e41d9e/stack_animation.webp)

6. **Scroll to the portfolio section and add details or images of completed projects to highlight your work.**

    ![](https://colony-recorder.s3.amazonaws.com/files/2025-09-12/64a2c951-67d1-42f6-b1d4-7211a92a8f56/stack_animation.webp)

## Confirmation
Your team profile updates will appear immediately in the Company Back Office and on public views like Job Connector listings. Refresh the page to confirm changes, such as the new name, images, or service areas displaying correctly.

## FAQ
**Why can't I see the Edit button on my team profile?**  
You need admin-level access (like Admin (GC) or Team Project Manager). If it's missing, contact your team admin to adjust your permissions via the Team Members settings.

**What happens if I change my team handle?**  
The handle updates your unique URL slug (e.g., @yournewhandle), but existing links may break. Notify connected users or subs, as it's visible in invitations and bids.

**Can I add multiple service areas?**  
Yes, select as many as needed during setup or edits. This improves job matching in Job Connector but doesn't restrict project creation outside those areas.

**How do I remove a portfolio item after adding it?**  
Click the edit icon next to the item in the portfolio section, then select delete. Confirm the action to remove it permanently from your profile.

**Is there a file size limit for profile images or banners?**  
Uploads are limited to 5MB per image. Use JPEG or PNG formats for best results; larger files may fail to upload.

## Related Articles
- Sign up for BuilderPal
- Create a Business Profile
- Manage Your Service Area
- Edit Personal Profile
- Manage Contacts
- Create Team Members

# Invite Contacts

## Summary
This tutorial covers how to invite new contacts to connect with your team in BuilderPal, including adding details, sending invitations, and alternative import methods. Inviting contacts helps build your network for collaboration on projects, bids, and subcontracting.

## Prerequisites
- You must have one of the following roles: Admin (GC), Admin (SUB), Admin (SHORTCUT), Team Project Manager, Team Finance Manager, or Team Business Manager.
- Access to the Team Office in BuilderPal at https://app.builderpal.com.

## Steps

1. **Navigate to the Contacts page in Team Office.** Go to the Team Office section and select Contacts to manage or add new connections.

    ![](https://colony-recorder.s3.amazonaws.com/files/2025-09-15/b2e1257a-a27c-452c-b7d2-034cd3c07911/stack_animation.webp)

2. **Click the plus button to add a new contact.** Locate the **+** button in the top right corner and click it to open the new contact form.

    ![](https://colony-recorder.s3.amazonaws.com/files/2025-09-15/963d34f9-9011-4786-b70b-f3d81e0c43bc/stack_animation.webp)

3. **Fill out the contact and company information.** Enter the required details for the individual contact, including any associated company information in the provided fields.

    ![](https://colony-recorder.s3.amazonaws.com/files/2025-09-15/d46fb248-19a9-4e0f-ad02-20a43c8b94de/stack_animation.webp)

4. **Click Save to send the invitation.** Review the entered information, then click **Save** to finalize and send an invitation for the contact to connect with your team.

    ![](https://ajeuwbhvhr.cloudimg.io/https://colony-recorder.s3.amazonaws.com/files/2025-09-15/813b7711-14bc-4846-9dd9-1ab6f3e10ec2/ascreenshot.jpeg?tl_px=189,158&br_px=1565,928&force_format=jpeg&q=100&width=1120.0&wat=1&wat_opacity=1&wat_gravity=northwest&wat_url=https://colony-recorder.s3.amazonaws.com/images/watermarks/0EA5E9_standard.png&wat_pad=524,527)

5. **Wait for the invited contact to accept the invitation.** The contact will receive a notification in their inbox; once accepted, the new team contact will appear in the Contacts page in Team Office.

    ![](https://colony-recorder.s3.amazonaws.com/files/2025-09-15/710fa38e-0c69-4bc8-a1e6-aa51a2c298a5/stack_animation.webp)

6. **Import contacts using BuilderPal AI.** Alternatively, upload a file or describe contacts to the BuilderPal AI helper to import them into your contacts list.

    ![](https://colony-recorder.s3.amazonaws.com/files/2025-09-15/d14ab822-a709-46a4-97dc-92ca2b59562e/stack_animation.webp)

## Confirmation
Once the invitation is sent and accepted, the new contact will be listed in your Contacts page in Team Office, ready for assignment to projects or bids. You'll see the updated contact list immediately after acceptance.

## FAQ
**Q: What if the contact doesn't receive the invitation?**  
A: Check the email or phone number entered for accuracy. Invitations are sent via notification in BuilderPal; resend by editing the contact and saving again.

**Q: Can I invite multiple contacts at once?**  
A: Yes, use the AI import method to upload a file with multiple contacts or describe them in bulk to the BuilderPal AI helper.

**Q: What happens if the contact declines the invitation?**  
A: The contact won't appear in your list, but you can reinvite them by adding the contact again and saving.

**Q: Are there any limits on the number of contacts I can invite?**  
A: No limits in the free plan, but ensure contacts align with your team's service areas for better matching.

**Q: How do I edit a contact after inviting?**  
A: Go to the Contacts page, select the contact, make changes, and save to update details without resending the invitation.

## Related Articles
- Manage Contacts
- Create Team Members
- Invite Bidders
- Edit Team Profile
- Manage Connections
- Create Groups

# Manage Taxes & Fees

## Summary
This tutorial guides you through adding and configuring taxes and fees in BuilderPal, ensuring accurate cost tracking and budgeting for your construction projects without affecting profitability calculations incorrectly.

## Prerequisites
- You must have one of the following roles: **Admin (GC)**, **Admin (SUB)**, **Admin (SHORTCUT)**, **Team Project Manager**, **Team Finance Manager**, or **Team Business Manager**.
- Access to the **Team Office** in BuilderPal at https://app.builderpal.com.

## Steps
1. **Navigate to the Taxes & Fees page** — go to the **Team Office** and select **Taxes & Fees**.

    ![](https://colony-recorder.s3.amazonaws.com/files/2025-09-28/5ea80c9f-d95d-4ef1-bc6c-00786115fc17/stack_animation.webp)

2. **Add a new tax or fee** — click the **+** button in the top right corner.

    ![](https://colony-recorder.s3.amazonaws.com/files/2025-09-28/b4a67e0d-4ff6-43f0-8c4a-99fafc4c540f/stack_animation.webp)

3. **Enter the details** — fill in the name, abbreviation, and description for the tax or fee.

    ![](https://colony-recorder.s3.amazonaws.com/files/2025-09-28/4f87ef20-0bea-4b11-a113-45c7a2836df6/stack_animation.webp)

4. **Configure category and settings** — select the category (**Tax**, **Fee**, or **Other**), unit type (% or dollar amount), and default amount. The status starts as inactive until used in a cost item; archived taxes/fees cannot be used with new cost items.

    ![](https://colony-recorder.s3.amazonaws.com/files/2025-09-28/07db7327-6653-40a0-948a-11e5da176356/stack_animation.webp)

5. **Set default options** — choose **Exclude from Budget** to hide it as a pass-through cost that doesn’t affect profit, and **On by Default** to apply it automatically to all new cost items.

    ![](https://colony-recorder.s3.amazonaws.com/files/2025-09-28/bc4447d9-a12c-44bb-8d37-77ddc7a5145f/stack_animation.webp)

6. **Save and verify** — click **Save**, then confirm by creating a new cost item in your project estimate and budget.

    ![](https://colony-recorder.s3.amazonaws.com/files/2025-09-28/bd4d5a87-37ff-4d66-adc5-53f1f7612e58/stack_animation.webp)

## Confirmation
You’ll know it worked when the tax or fee appears in your list, changes to active upon use in a cost item, and applies correctly without impacting budgets if excluded.

## FAQ
Q: Why is my tax or fee showing as inactive?  
A: New taxes and fees start inactive and become active only after being used in at least one cost item.

Q: What happens if I archive a tax or fee?  
A: Archived items cannot be applied to new cost items, but they remain on existing ones.

Q: How does "Exclude from Budget" affect my projects?  
A: It treats the tax or fee as a pass-through cost, hiding it from budget calculations to avoid impacting profit margins.

Q: Can I edit a tax or fee after saving?  
A: Yes, return to the Taxes & Fees page and click on the item to edit its details, but changes may not retroactively apply to existing cost items.

Q: What's the purpose of the abbreviation field?  
A: The abbreviation provides a short code for quick reference in estimates, budgets, and reports.

## Related Articles
- Manage Cost Codes
- Create a Budget
- Finance Center Overview
- Edit Project Budget
- Budget Report

# Manage Service Areas



# Adjust Team Timezone



# Manage Team Member Permissions