Skip to content

Project Setup

This page explains how BlenderSync is set up for a Revit document.

Setup is where you choose which Revit view BlenderSync follows, how the document appears in Blender, and which connection settings are used for synchronization. Getting this right early makes syncing more predictable and much easier to troubleshoot later.

For most people, this is the most important part of the workflow.

Open Setup

Open Setup from the Settings panel to view or change BlenderSync settings for the current Revit document.

Setup can be reopened at any time.

Setup is stored per document

BlenderSync stores its setup in the Revit document itself. Each document keeps its own settings.

That means the setup stays with the file. If the same Revit document is opened on another machine, its BlenderSync settings are still available. When the document opens, any saved Setup values are loaded automatically.

If a document already has saved settings, Setup opens with those values prefilled.

Setup fields

The Setup dialog includes these fields:

  • Revit View
  • Display Name
  • Server
  • Port
  • Document ID

In most workflows, the main fields to pay attention to are Revit View and, if needed, Display Name. In a standard local setup, Server and Port usually stay at their default values. Document ID is mainly useful for debugging.

Revit View

Revit View defines the 3D view BlenderSync uses as its synchronization source.

Only non-template 3D views appear in the dropdown. The selected view does not need to be the active view on screen when you sync.

Both orthographic and perspective 3D views are supported. Section boxes are also supported.

In practice, it is usually best to create a dedicated 3D sync view. That gives you a stable source for BlenderSync and makes it easier to control exactly what Blender receives over time.

Display Name

Display Name is the human-readable name used in Blender to identify the synchronized document.

By default, BlenderSync uses the Revit file name without the file extension.

If you have not set a custom Display Name, renaming the Revit file updates it automatically. If you do set a custom Display Name, later file renames will not overwrite it.

Server and Port

Server and Port define where BlenderSync for Revit connects.

In a standard local setup, the defaults are:

  • Server: 127.0.0.1
  • Port: 3000

You can change these values in Setup if needed. Saved changes take effect immediately.

Document ID

Document ID is shown in Setup for debugging.

It is created automatically if one does not already exist, and it is stored per Revit document. Most users do not need to change or manage it.

What happens before Setup is saved

BlenderSync can still operate even if Setup has not been saved yet, as long as the document contains a valid 3D view.

In that case, BlenderSync uses these defaults:

  • the first available non-template 3D view is used as the source
  • the Revit file name without the extension as the Display Name
  • 127.0.0.1 for Server
  • 3000 for Port

This allows you to get started quickly, but it is still better to configure Setup intentionally so the source view is explicit and predictable.

If the document contains no 3D views, BlenderSync has no view available for synchronization.

The source view controls the result

BlenderSync uses the current state of the configured source view when synchronization runs.

In other words, that 3D view is the source of truth for what Blender receives. BlenderSync follows the final visible result of the configured view.

Because of that, changes to the source view can change the synchronized result. This is one reason a dedicated sync view is usually the safest and most consistent approach.

If the configured source view is missing

If the configured source view is later removed from the document, BlenderSync falls back to the first available 3D view.

That fallback is then stored.

If sync results start looking different than expected, it is worth reopening Setup to confirm which 3D view is currently configured.

Next step

Once Setup is in place, continue to Commands to learn when to use Changes, Selected, Capture, Start, and Stop.