Getting Started With Speckle For Unreal

Getting Started With Speckle For Unreal

Ready for some fancy global illumination? Read our quick start guide for the Speckle Connector for Unreal.

Cristian Balas
Cristian Balas

The Speckle Connector for Unreal is in its early stages - you've been warned! In its current stage, it's more a developer tool than a ready to use connector.

That aside, here's a quick guide on how to get started with it!

::: tip Prerequisites

To follow along with this tutorial, you will need to register with Speckle and install the required connectors 🔌. It takes less than 3 minutes!

For a comprehensive overview of this connector, check our docs 📚!



The Unreal connector is packaged as an Unreal Engine 4 plugin that is currently only available through GitHub. To use it in your project:

  1. Download the speckle-unreal repository archive from
  2. Extract the downloaded archive into your project's Plugins directory (if your project directory doesn't contain a directory called Plugins, you should create it)
Extract archive to your project's "Plugins" directory.
  1. Open your UE4 project (or restart the editor if you already have it opened). This will build the plugin in your environment.

That's It! Your project can now use the Speckle plugin!

For additional resources, see Unreal's guides on Installing Unreal Engine,
Setting Up Visual Studio for Unreal Engine,
and Create a New Project.


The plugin includes an actor type named Speckle Unreal Manager that you can use to import objects from Speckle.

Here is how to use it:

1. In the Place Actors sidebar, search for Speckle Unreal Manager and add it to the world.

2. Select the SpeckleUnrealManager instance in the World Outliner sidebar and use the options presented in the Speckle category

3. Currently, we require an explicit ObjectID to import. You can explore the objects in a stream by using the Speckle Web App for the Speckle server that you use.

4. If your Speckle Stream is not public, you must generate a Personal Access Token and set it in the Auth Token configuration option.

::: warning

Treat your Personal Access Token as a password. If someone else has access to your auth token, they can access to your Speckle data.


5. After you set up the import parameters, just click the Import Speckle Object button. The specified object and all its children will be important as mesh actors.

Source Code

All the code is available in our Github repository. Feel free to clone, fork and open issues!

Don't forget to ⭐ our repos if you like what you see!


We hope you enjoyed this tutorial and found it useful!

Please see our docs for more!

Speckle is an Open Source project and we really ❤️ feedback, so if you have any questions, comments, critiques, or praises please let us know on our community forum.

Have a question you need answered?

Submit your question on the forum and get help from the community.

Ask a question

Empowering your design and construction data

© Aec Systems Ltd. Speckle and Speckle Systems are trademarks of AEC Systems Ltd., registered in the UK and in other countries. Company No. 12403784.

Terms of service | Privacy policy