AlphaAlpha Docs

Exporting Models

How to export Revit model groups to the Alpha platform

Exporting Models

The add-in provides three ways to export model groups from Revit to the Alpha platform, all found in the Export panel of the Alpha ribbon.

Export Selected Groups

Use Export Selected Groups to export specific model groups you have selected in the Revit viewport. Each group is uploaded to the type-level product coverage matching the group's name — use this for shared per-type models (interiors, kitchens, bathrooms) that are reused across every project that uses the type. Groups whose names don't exist as a coverage row are exported to disk only.

Workflow

  1. Select one or more model groups in the Revit viewport
  2. Click Export Selected Groups in the Export panel
  3. A progress window appears showing each group being exported
  4. When complete, a summary dialog shows the results

What Happens During Export

For each selected model group, the add-in:

  1. Validates that the element is an exportable model group
  2. Exports the group in the enabled formats (GLB, RVT, IFC, PDF)
  3. Saves files to the configured export output directory
  4. Uploads files to the Alpha platform (if upload is enabled)

Progress and Cancellation

The export progress window shows:

  • Current group name and number (e.g., "Group 2 of 5")
  • Current export step
  • Any warnings encountered

Click Cancel at any time to stop the export. Files already exported remain on disk, but the remaining groups are skipped.

Export Summary

After export completes, a summary dialog shows:

  • Number of groups exported successfully
  • Number of failures (if any)
  • For each group: file sizes and upload status
  • Total elapsed time

Export Visible in View

Use Export Visible in View to export model groups from the active 3D view without manually picking each one.

Workflow

  1. Open a view that contains the model groups you want to export
  2. Click Export Visible in View in the Export panel
  3. A dialog appears listing the model groups found in the document
  4. Select the groups you want to export
  5. Click Export to begin

This is useful when you want to export many groups at once without manually selecting them in the viewport. Exports and uploads work the same as Export Selected Groups — only the source set differs.

Export As Project Variants

Use Export As Project Variants to export selected groups as project-specific models instead of shared type-level coverage. This covers two cases: project-level overrides of CONCEPT models, and variant facade models.

Workflow

  1. Select one or more model groups in the Revit viewport
  2. Click Export As Project Variants in the Export panel
  3. A picker dialog appears — choose the target type and project (the selection is saved as the default for next time)
  4. Each selected group is exported, and the upload destination is auto-routed by matching the group's name against the project's model catalogue

Upload Routing

For each exported group, the add-in matches the (cleaned) group name against the project's concept and variant models:

MatchDestination
Group name matches a CONCEPT modelGLB, RVT, and thumbnail are uploaded as a project-level concept model override (POST /projects/{projectId}/concept-model-overrides/{treeId}/{name})
Group name matches a variant facade modelFiles are uploaded to the type-level coverage row for that variant (POST /type-product-coverages/upload/{typeId}/{name})
No matchThe group is exported to disk only — a warning is shown and no upload happens

When the same product name exists as both a concept and a variant model, the variant model takes precedence.

Export Summary

The completion dialog shows, per group, the upload target (CONCEPT or VARIANT with the variant ID), file sizes, upload status, and duration. Failed groups list their error, with an option to copy error details to the clipboard.

Output Formats

FormatExtensionDescription
GLB.glbBinary glTF format for 3D visualization in the Alpha platform
RVT.rvtNative Revit file for archival and downstream use
IFC.ifcIndustry Foundation Classes for BIM interoperability
PDF.pdf2D drawings exported from the model

Enable or disable formats in Settings.

Output Directory Structure

Exported files are organized by group name:

%UserProfile%\Alpha\exports\
  └── GroupName\
      ├── GroupName.glb
      ├── GroupName.rvt
      ├── GroupName.ifc
      └── GroupName.pdf

Uploading to Alpha

When Upload Outputs is enabled in settings, exported files are automatically uploaded to the Alpha platform and linked to the corresponding type coverage. You can verify the upload by checking the coverage status in the Missing Coverage view.

Tips

  • Run a Health Check before exporting to catch common model issues
  • Use Rename Group to ensure group names match Alpha product type names before exporting
  • Check Missing Coverage after exporting to verify all types are covered

On this page