Family Browser Help

ValorVDC Family Browser

A free dockable palette for Revit that lets you browse, search, and place any loaded family type with a single click. In Revit, hover over the Family Browser button and press F1 to open this page.

Install

Family Browser installs with a standard Windows installer (.msi) and requires Administrator access.

  1. Download ValorVDC_FamilyBrowser_1.1.0.msi from the Autodesk App Store.
  2. Right-click the file and choose Run as administrator, or double-click it if you already have an admin account.
  3. Follow the installer prompts and accept the license agreement.
  4. Start Revit. The Family Browser button appears in the Add-Ins tab under the Family Tools panel.

The installer covers all supported Revit versions on the machine (2024–2027). You do not need to run it separately for each version.

Open the palette

Click Family Browser in the Add-Ins › Family Tools panel. The palette opens as a dockable panel — you can float it, dock it left or right, or pin it next to the Properties panel. Click the button again to hide it.

The palette loads automatically when you open or create a Revit project. If you switch to a different project, click the ⟳ refresh button to reload from the new model.

Place a family

Open a Revit project — the palette shows every family type loaded in that model as a visual tile with a thumbnail preview. Click any tile to immediately start placing that family type in the model.

The placement command stays active so you can click multiple times to place several instances. Press ESC when you are done placing.

Placement indicator

While the placement command is active, the palette gives visual feedback so you always know Revit is in placement mode:

  • Revit 2025–2027: The entire palette background turns light blue.
  • Revit 2024: A blue banner appears at the top of the palette showing the active family name.

The indicator clears automatically when you press ESC (Revit 2025–2027), or when you click another tile or use the refresh / setup button (Revit 2024).

Configure the palette

Use Setup mode to choose exactly which categories and family types appear in the palette.

  1. Click the ⚙ Setup button at the top-right of the palette.
  2. Expand a category with the ▶ toggle to see its family types.
  3. Check or uncheck individual types. Use the All and None buttons on a category row to select everything at once.
  4. Use the global All and None buttons in the header bar to select or clear every type across all categories.
  5. Choose where to save (see Project vs. user settings below).
  6. Click Save to Project or Save to My Account to apply. The palette reloads in browse mode showing only your chosen types.

Click ← Browse at any time to go back without saving. Your previous settings are restored.

Project vs. user settings

Save to: This Project

Settings are stored inside the Revit file using Revit's extensible storage. They travel with the .rvt file and are visible to any team member who has Family Browser installed. Use this when everyone on the project should see the same palette.

Save to: My Account

Settings are stored in %AppData%\ValorVDC\FamilyBrowser\ on your machine and apply the same palette configuration to every project you open. Use this for personal preferences that should follow you across projects.

If both project and user settings exist for a project, project settings take priority.

Troubleshooting

The Family Browser button doesn't appear in the Add-Ins tab

Make sure the installer was run as Administrator. Close Revit, run the installer again, then restart Revit. Also check that no old version of the plugin is installed in C:\ProgramData\Autodesk\Revit\Addins\<year>\ — delete any ValorVDC_FamilyBrowser.* files there if you find them.

The palette says "Open a project to load the palette"

Open or create a Revit project. The palette reads family data from the active model and cannot show anything until a project is open.

No families appear after loading

Click ⚙ Setup, then use the global All button to make every category visible, and save. If the project has no loadable families, load some through Insert › Load Family first, then click the ⟳ refresh button.

The version shown in the palette is older than the installed MSI

An older installation may still exist in C:\ProgramData\Autodesk\Revit\Addins\<year>\ from a previous release. Delete any ValorVDC_FamilyBrowser.* files in those folders and restart Revit.

F1 doesn't open this page

Hover over the Family Browser ribbon button until its tooltip appears, then press F1. On a laptop keyboard you may need to hold Fn at the same time.

Blue placement tint doesn't appear (Revit 2024)

This is a known Revit 2024 API limitation — the full background tint isn't available in that version. A blue banner at the top of the palette is shown instead. This is expected behaviour.

Uninstall

Close Revit, then open Windows Settings › Apps › Installed apps, find ValorVDC Family Browser and choose Uninstall. All plugin files are removed automatically.

User settings stored in %AppData%\ValorVDC\FamilyBrowser\ are not removed by the uninstaller. Delete that folder manually if you want to remove them completely.

Contact support

Email support@valorvdc.com, or open an issue on GitHub. To help us fix a problem quickly, please include:

  • Your Revit version and Family Browser version (shown in the palette footer when Setup mode is open)
  • What you were doing and the steps to repeat the problem
  • What you expected to happen, and what happened instead
  • A screenshot of any error message