Revit® Add-In · tool tPalette

The long-awaited
Tool Palette for Revit
®

A dockable, fully-customizable button launcher built for Revit® professionals. Place families, symbols, run actions, open files, and automate workflows — all from a single searchable panel.

Revit 2023–2027 Version 1.0 .NET 10 / .NET 8 / .NET 4.8
P-007-resized-20260504031423-fece20.png

Core Capabilities

Everything in the tool palette.

The palette panel gathers all families from either the current document, external files or folders, and turns them into a clickable buttons. It's featured with very versatile, customizable and parametric data fetching.

Dockable Panel

Registers as a native Revit® pane — docks, floats, and resizes exactly like built-in panels.

Dockable and resizable
📑

Tabbed Organization

Unlimited named tabs per palette. Formats: Custom, Doc Fetch (live from Revit), Template Fetch or Folder Fetch (RFAs on disk).

Custom · Doc Fetch - Template Fetch · Folder Fetch
🔍

Live Search & Sort

Instant filter across Label, Group, and Category fields. Sort A→Z, Z→A, or default order plus favorite  and recent order.

Label · Group · Category

Favorites

Click star on any button to mark as favorite then sort it to the order. A dedicated Favorites tab aggregates starred buttons from all tabs.

Cross-tab · Persistent
🖱️

Type Options Flyout

Family buttons expand a sub-list of type variants on click. Options to expand one button at a time or additive expansion.

Expand - Collapse
🎨

Custom Icons

Each button supports a custom PNG icon. If none is supplied, an initials-based avatar is auto-generated.

PNG · SVG glyphs · Auto-avatar
↕️

Separators with Labels

Insert visual separator rows between button groups with optional inline labels for scannable long lists.

Grouping · Visual hierarchy
🔄

Live Reload

Reload button dispatches an ExternalEvent on the Revit API thread, re-fetches all dynamic tabs — no restart needed.

ExternalEvent · Zero-restart
🖥️

Theme Sync

Auto-detects Revit's Light/Dark theme via polling timer and re-applies the matching palette theme definition.

Light · Dark · System
🔒

Security & Permissions

A security sidecar controls which Windows users can open the editor. Password hashing supported.

Admin · Network · Roles

Add from Selection

Right-click a Revit element → Add to Palette. Single-element uses single-add; multi-selection uses bulk-add.

Available on 2025 2026 2027
🔁

SHIFT+Right-Click Repeat

Optional shortcut repeats the last-run button action without navigating back to the palette.

Optional · Configurable

New Section

Take control.

The plugin comes with multiple palettes for you to use right away. Tweak them to make them your own, or create a fresh one from scratch with your specification.

Palette-ASMEP-20260502163457-dc6a53.png
Width: Align:
Interaction Model

Smart button behaviors.

Every button has a consistent, predictable interaction model with contextual overrides.

 🖱️Single Click

Raises PaletteActionBridge on the Revit API thread. Places the family type or executes the configured action with parameters.

🔃 SHIFT + Right Click Repeat

When enabled, SHIFT + Right Click repeats the last-executed action — ideal for repetitive placement tasks.

🔎 Inline Search

The search box filters all rows in real-time. Matches on Label, Group, and Category. Separators hide if all child rows are filtered.

⭐ Favorites Toggle

Click ☆ on button to add to favorites (☆ → ★). Favorites persist to a local user profile and appear in the Favorites tab.

⬆️ Active Command Indicator

Active command rows are highlighted green. Active Button Cancellation can cancel the command on click or Enter key.

⚠️ Missing Family Warning

If a button's family isn't loaded, a warning indicator appears. The palette can auto-load from the configured source path.

🙈 Hide / Unhide

Hidden buttons are suppressed in the live palette but remain visible in the editor with an Unhide control.

🖱️ SHIFT + Mouse wheel scroll

While the palette is active, scroll through available tabs to faster using the  mouse wheel up and down.

Expand and Collapse

Button expands when there's  more that one types in the family. Only one button expands at a time, but this can be turned off in the Settings.

Built-In Action Pack

12 powerful Actions.
Zero scripting required.

Every button can be a family placer or a parameterized Action that fires on the Revit API thread. The Action list has extensibility surfaces by downloading Custom Action Packs, 

🎯

Revit file opener

Open an RVT or RTE in the current session

↗️

Text Leader

Places a leader text note with configurable shoulder length.

🏷️

Category Tag Leader

Tags elements with leader lines configurable shoulder length and per-category assignment.

📝

Text Notes

Places a text note with configured type, content, and box width.

📋

Rich Text Notes

Places a coordinated header + body text block pair with borders and formatting.

🎯

Symbol Leader

Opens the folder of the current Revit document in Explorer.

📁

Document Folder

Tags elements with leader lines configurable shoulder length and per-category assignment.

📄

File Opener

Opens any file using its default Windows application.

🔗

Revit Link Opener

Opens the current document's linked Revit files.

📁

Open Folder

Opens a configured file-system folder path in Explorer.

🎛️

Apply Filter

Applies a named view filter to one or more view templates.

📊

Sheet Parameter

Sets sheet parameters across multiple sheets in bulk.

🎛️
Apply Filter
BIMGrove.ApplyFilter
Parameter KeyDescription
Filter NameName of the view filter
View Template NameTarget view template names
Filter togglesEnable/disable, visibility, halftone
Filter propertiesPattern, Color, Weight
Prompt togglesEnable prompts or use pre-configured settings
Applies a named view filter to one or more view templates.

Accessibility

Inclusive by design.

The palette follows WPF accessibility conventions and Revit's theming contract.

THEME

System Theme Sync

Automatically follows Revit's Light and Dark themes. Users never need to manually switch — the palette matches the host app at all times.

KEYBOARD

Search Keyboard Navigation

Search field is fully keyboard-driven. Esc clears. Tab navigates out. Type-to-search activates instantly.

CONTRAST

High Contrast Text

Text colors in both themes are selected to maintain sufficient contrast, with distinct muted-text values for secondary labels.

STATUS

Status Bar Feedback

Every action execution writes a status message — success, cancellation, or descriptive errors — so users always know what happened.

TOOLTIP

Runtime Tooltips

Button tooltips include family/category/type info resolved at runtime. Missing-family indicators surfaced as tooltip text.

ICONS

Icon Fallback

When no icon is provided, an initials-based avatar is auto-generated and auto-colored — every button is visually distinct.

FAQ

Frequently asked questions.

What is the difference between a Custom tab and a Doc Fetch tab?
A Custom tab shows hand-authored buttons stored in the palette JSON. A Doc Fetch tab dynamically queries the active Revit document using configured categories and filters, rebuilding the button list at every reload.
How do I add a button from the Revit canvas without opening the editor?
Select elements in Revit, right-click → Add to Palette. The editor opens pre-populated with the selection data. Multi-selection automatically switches to bulk-add mode.
Why does my custom icon not appear?
Resolution order: (1) absolute PNG path, (2) filename relative to assets/icons/, (3) family thumbnail (fetch format), (4) initials avatar fallback. Verify the path exists and uses double backslashes or forward slashes in JSON.
How does the Active Button Cancellation feature work?
When a button places a family or runs a command, it becomes the active command and highlights green. Clicking the highlighted button again cancels the placement. Mode can be set to click or enter in ui_settings.active_button_cancellation_mode.
How do I restrict which users can open the Editor?
Create a security.json file in the palette data folder. Set editor_password (plain text) or use PBKDF2 hash fields. Add Windows usernames to editor_password_admin_users to bypass the password prompt. The prime_admin user always has full access.
Explore EditorTool Palette DocumentationTool Palette LicensingVersion Log →