Importing Datasmith Content into Unreal Engine 4

Detailed instructions on how to use Datasmith to bring files that you've created in supported 3D design applications into Unreal.

Windows
MacOS
Linux
On this page

This page describes how to use Datasmith to import content from a supported 3D design application or file format into Unreal.

Prerequisites:

  • For most file formats supported by Datasmith, you don't need any additional software to be installed on your computer. All you need is the file that you want to import. However, the following file formats have specific requirements:

    • .wire - In order to use Datasmith to import a .wire file, you must have a version of Autodesk Alias AutoStudio installed that is compatible with your .wire file.

You can also use Python to automate the process of importing files through Datasmith. For details, see Customizing the Datasmith Import Process .

Steps

  1. In the Unreal Editor, open the Project that you want to import your Datasmith content into.

  2. If you want to bring your content into an existing Level in your Project, open it now. Otherwise, create a new Level or just use the default one.

  3. From the main toolbar, find the Datasmith button:
    The Datasmith importer in the Toolbar

    If you don't see this button in the Toolbar, you'll need to enable the Datasmith import plugins for the source file types you want to use. See Project Setup below.

  4. Use the drop-down arrow to choose the type of Datasmith importer you need to use:
    List of Datasmith importers
    This choice depends on the type of source file you are importing.

    For a complete list, see Datasmith Supported Software and File Types .

  5. In the Import window, browse to and select the file you want to import. Click Open.
    Choose a file to import

  6. Choose a folder in your Project content for Datasmith to put the newly imported assets.
    Choose a content folder

    If you want to create a new folder for your Datasmith content, right-click an existing folder in this window.

  7. Use the Datasmith Import Options window to select the types of content that you want to import from your source file, and set optional additional parameters that control the import process.
    Set import options
    The options that you can set here depend on the type of file you're importing. For details, see Datasmith Import Options .

  8. Click Import. Datasmith reads your source file, creates new assets in your Project, and places the Datasmith Scene into your current Level. For details on this process, see the Datasmith Overview .

Project Setup

Datasmith offers multiple different importers to support different types of source files and design applications. Each of these importers is wrapped in its own plugin. Depending on the Template you used to create your Unreal Engine Project, you may need to enable the plugin that contains the Datasmith importer for the type of file you want to import.

If you start your Project from one of the Templates in the Architecture, Engineering, and Construction or Automotive, Product Design, and Manufacturing categories, some or all of these plugins may be enabled for you already.

Select Skin
Light
Dark

Welcome to the new Unreal Engine 4 Documentation site!

We're working on lots of new features including a feedback system so you can tell us how we are doing. It's not quite ready for use in the wild yet, so head over to the Documentation Feedback forum to tell us about this page or call out any issues you are encountering in the meantime.

We'll be sure to let you know when the new system is up and running.

Post Feedback