Layer Mapping

Customize Rhino layers from Revit exports

When exporting from Revit with RAY, Rhino layers are created automatically based on Revit element properties. To customize how elements are organized, you can define your own layer mapping file.

Creating a mapping file

By default, RAY looks for the mapping file at:

C:\ProgramData\Beam\Mapping.txt

The mapping file is a plain text (.txt) file.

The file has two parts:

  1. First line: the pattern used to build layer names.

  2. Following lines: category conversion pairs that replace {Category} with custom text.

The pattern line

The first line of the file defines the layer naming pattern.

A pattern can include:

  • Free text → literal text that will appear as written

  • Keywords → placeholders in {braces} replaced with Revit values

  • :: → creates a new Rhino sublayer

Supported keywords

  • {Project} – the Revit project name

  • {Category} – the Revit category of the element (e.g. Walls, Floors)

  • {Subcategory} – the subcategory of the element

  • {Family} – the family name of the element

  • {FamilyAndType} – the family name combined with the type name

  • {Type} – the type name of the element

for example

After the pattern line, you can override how {Category} prints by adding category conversion lines.

fo example

Lines in the mapping file that start with # are treated as comments and ignored during export.

Example Mapping File

PreviousRAYNextDynamo®

Last updated