Introduction

Cupix Reality Importer is an Autodesk Revit plug-in that imports point cloud data captured in CupixWorks directly into your Revit project.

Starting with version 1.1.1, Reality Importer supports Cupix Alignment Data — an optional JSON file exported from CupixWorks that places the imported point cloud at the exact position aligned with your BIM model. With Alignment Data, no manual placement is required.

• Supported Revit versions: 2024, 2025, 2026
• Supported point cloud formats: CPC, PLY, E57, XYZ
• Optional alignment file: Cupix Alignment Data (.json)

Install Cupix Reality Importer

1. Open the Autodesk App Store. (Direct link to the app: Cupix Reality Importer)
2. Search for Cupix Reality Importer.
3. Click Download and run the installer for your Revit version (2024, 2025, or 2026).
4. Restart Revit if it was running during installation. 

Import Point Cloud Data

1. Open your Revit project.
2. Go to the Add-Ins tab → External Tools → Cupix Reality Importer.

3. The Cupix Reality Importer dialog opens. Fill in the fields:
   1. Point Cloud File Required — Select a CPC, PLY, E57, or XYZ file.
   2. Cupix Alignment Data Optional — Select the JSON file exported from CupixWorks (see next section). When provided, the point cloud is automatically placed in the exact position aligned with your BIM.
4. Click Import.

Note: If you imported with Alignment Data, the point cloud appears precisely aligned to the BIM coordinates. Without it, you may need to position the point cloud manually using Revit's standard tools.

Export Alignment Data from CupixWorks

To get the Cupix Alignment Data JSON file used in the previous step:

1. Sign in to CupixWorks and open Project Center.
2. Go to BIM Files. You will see the list of BIM files uploaded to the project.
3. Click the BIM file you want to align with. A drawer opens on the right.
4. Click the Export Alignment button. A JSON file downloads to your computer.
5. Use this JSON file as the Cupix Alignment Data input in Reality Importer.