> For the complete documentation index, see [llms.txt](https://help.filed.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.filed.com/reference/workspace-and-settings/firm-settings.md).

# Firm settings

Firm settings is the default landing page of Settings and is visible to all members. Admins can update the firm's display name and description. All members can view the tab and switch between workspaces they belong to.

## Firm name

The **Firm name** field holds the display name for your workspace as it appears throughout the app. The placeholder example shown is "e.g. Chen & Torres CPA". The name must be non-empty before the Save details button becomes active.

## About

The **About** field is a four-row textarea for a short description of your practice - branding context or a brief summary of the firm's focus. Example placeholder: "We're a CPA firm specialising in small business tax returns and bookkeeping in New York." The field is optional; leaving it blank has no effect on other functionality.

## Saving changes

Admins click **Save details** to persist any edits to the firm name or About description. The button is disabled when there are no unsaved changes or when the name field is empty. A success toast confirms the update; a failure toast prompts you to try again.

## Switching firms

If your account belongs to more than one workspace, a **Switch firm** button appears in the top-right area of the Firm Settings page. Clicking it opens a searchable dialog listing the other workspaces you are part of, paginated at five per page. Select a workspace and click **Switch** to move into it; the app navigates to that workspace's home page.

## Creating a new firm

A **Create a firm** option is available from the three-dot menu next to the Switch firm button. It navigates to the firm onboarding flow at `/onboarding/firm`. Use this when your practice needs a separate workspace, for example a distinct legal entity or office. If you only need to add people to an existing workspace, use Members instead.

**Walkthrough: update firm details**

1. On the Firm tab, edit the **Firm name** and/or **About** fields. The **Save details** button activates once there is an unsaved change (and the name is not empty).

![The Firm Settings form with the name, About field, and Save details button](https://storage.googleapis.com/filed-prod-public-assets/walkthroughs/firm-settings/image1.webp)

2. Click **Save details**. A success toast ("Firm updated") confirms the change and the button returns to its disabled state.

![The "Firm updated" success toast](https://storage.googleapis.com/filed-prod-public-assets/walkthroughs/firm-settings/image2.webp)

**Walkthrough: switch firms**

If your account belongs to more than one workspace, click **Switch firm** in the top-right. A searchable dialog lists the other firms you are part of (five per page). Use the search box to find a firm, then click **Switch** to move into it.

![The Switch firm dialog with the search box and firm list](https://storage.googleapis.com/filed-prod-public-assets/walkthroughs/firm-settings/image3.webp)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.filed.com/reference/workspace-and-settings/firm-settings.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
