docs.unity3d.com
Search Results for

    Show / Hide Table of Contents

    Import a URDF file

    Import a .urdf robot description into your project and generate the corresponding Unity GameObject hierarchy.

    Simulation Pro ships its own Unified Robot Description Format (URDF) importer. It parses a .urdf robot description and instantiates the corresponding Unity GameObject hierarchy with ArticulationBody joints, meshes, materials, and colliders, so you don't need to author the hierarchy manually.

    Unity automatically imports any file with a .urdf extension. To import a URDF file:

    1. Copy the .urdf file, together with any referenced mesh, texture, and material files, into your project's Assets folder.
    2. Unity imports it as an asset whose main object is the robot's root GameObject, a prefab-like hierarchy you can drag into a scene.
    3. Select the .urdf asset to configure import options in the Inspector, then select Apply to re-import.

    Unity resolves referenced files relative to the .urdf file. The importer understands package:// and file:// URIs, and plain relative paths.

    Note

    Simulation Pro doesn't support Xacro macros. The importer rejects any URDF that uses XML namespaces, so export your Xacro file to pure URDF with the ROS tooling first.

    Additional resources

    • URDF Importer inspector reference
    • Output hierarchy reference
    • Configure collision mesh decomposition
    • Handle mesh and Collada files
    In This Article
    Back to top
    Copyright © 2026 Unity Technologies — Trademarks and terms of use
    • Legal
    • Privacy Policy
    • Cookie Policy
    • Do Not Sell or Share My Personal Information
    • Your Privacy Choices (Cookie Settings)