Skip to main content
The #3d command imports 3D model files into your app for use in augmented reality experiences, interactive 3D viewers, and SceneKit scenes. Drop in a USDZ or Reality file and tell the AI how to display it.

​
What It Does

When you use #3d, the AI:
  1. Adds the 3D model file to your Xcode project
  2. Sets up the appropriate framework (RealityKit for AR, SceneKit for 3D viewers)
  3. Creates a view that renders and displays the model as you describe

​
Supported Formats

FormatBest forNotes
USDZ3D viewing, AR experiencesApple’s preferred 3D format. Single-file, self-contained.
RealityAR scenes with behaviorsCreated in Reality Composer. Can include animations and interactions.

​
How to Use

1

Type #3d in the chat

Type # and select 3d from the toolkit popover.
2

Select your 3D model

The file picker opens, filtered to USDZ and Reality files. Choose the model you want to import.
3

Describe how to display it

The model appears as an orange chip below the input. Tell the AI how users should interact with the 3D content.
4

Send your message

Press Enter. The AI sets up the 3D rendering framework and creates the view.

​
Example Prompts

Show this 3D model in an AR view so users can place it in their room

Display this model in a 3D viewer that users can rotate

Use this USDZ model as a product preview

Show this model in AR with a 'Place Object' button

Create a 3D gallery where users can swipe between this and other models

​
Getting 3D Models

Reality Converter is a free app from Apple that converts OBJ, GLTF, and other common 3D formats to USDZ. Download it from the Apple developer site.
Many models on Sketchfab can be downloaded in USDZ format. Check the license for each model.
Apple’s Reality Composer app lets you create AR scenes with built-in 3D objects, animations, and behaviors. It exports .reality files that work directly with #3d.
USDZ is Apple’s preferred 3D format. You can convert other formats (OBJ, GLTF, FBX) to USDZ using Reality Converter, a free app from Apple.

​
AR vs 3D Viewer

Your prompt determines how the model is displayed:
ApproachWhat it createsBest for
AR viewCamera-based view where users place the model in the real worldFurniture, decorations, products users want to visualize in their space
3D viewerInteractive viewer where users can rotate, zoom, and inspect the modelProduct previews, educational models, 3D portfolios
If you want AR, mention “AR” in your prompt. If you want a static viewer, mention “rotate” or “3D viewer.”
AR features require a physical device — they won’t work in the Simulator. Use TestFlight to test AR on a real iPhone or iPad.
3D model files can be large. Complex models with detailed textures may increase your app size significantly. Optimize your models before importing — reduce polygon count and compress textures where possible.

Toolkit Overview

See all available # commands and how the toolkit works.

TestFlight

Deploy your app to a physical device to test AR features.