Skip to main content

Supported 3D File Formats

Composer supports multiple 3D file formats, each with different capabilities and use cases. This guide helps you choose the right format for your needs.

Format Comparison Table​

Composer loads six extensions: .glb, .gltf, .splat, .ply, .stl and .obj. Anything else is refused by Add model. A link typed straight into a model's URL field is not checked, and a file in any other format simply fails to load.

FormatExtensionMaterialsTexturesAnimationsMaterial variantsNode ControlBest For
GLB Recommended.glbSupportedSupportedSupportedSupportedSupportedProduction
GLTF.gltfSupportedSupportedSupportedSupportedSupportedDevelopment
SPLAT.splatThrough Gaussian splatsThrough Gaussian splatsNot supportedNot supportedNot supportedGaussian splatting
PLY.plyThrough Gaussian splatsThrough Gaussian splatsNot supportedNot supportedNot supportedGaussian splat and scan output
STL.stlNot supportedNot supportedNot supportedNot supportedNot supportedCAD exports
OBJ.objNot supportedNot supportedNot supportedNot supportedNot supportedLegacy meshes

Recommended Recommended for production
Through Gaussian splats Photorealistic appearance achieved through 3D Gaussian Splatting (3DGS) ellipses instead of traditional materials/textures

Material variants means the alternative material sets baked into a glTF with KHR_materials_variants, and Node Control means showing and hiding the parts inside one file. Those two columns are what a configurator is built from, and only glTF and GLB have them. Every format can still be shown or hidden as a whole, positioned, rotated, scaled and given transform variants, because those are set on the model rather than inside the file.


File Extension: .glb
MIME Type: model/gltf-binary
Best For: Production eCommerce use

Advantages​

Strength Single File - All data in one file (geometry, materials, textures)
Strength Smallest Size - Binary format is compact
Strength Fastest Loading - Optimized for web delivery
Strength Full Features - Supports all Composer capabilities
Strength Industry Standard - Widely supported across platforms
Strength PBR Materials - Physically-based rendering support
Strength Material Variants - Multiple material configurations
Strength Node Hierarchy - Full control over object parts

The catamaran is one: the 20 m boat is a 7.1 MB GLB holding nearly 1.4 million triangles, 115 materials, 63 textures and 15 material variants.

When to Use​

  • Suits Production eCommerce products
  • Suits Interactive configurators
  • Suits Models with textures and materials
  • Suits Files that need to load quickly
  • Suits When using variant matching features

Creating GLB Files​

From Blender:

  1. File → Export → glTF 2.0
  2. Format: glTF Binary (.glb)
  3. Enable: Include → Selected Objects, Materials, Textures
  4. Enable: Compression → Draco (optional, reduces size)
  5. Export

GLB Optimization Tips​

  1. Compress Textures

    • Use JPEG or WebP for base colour, and WebP or PNG where you need transparency (JPEG has none)
    • Use the smallest resolution that still looks right: 512 px or less covers most surfaces, 2048 px only large ones seen close up
    • JPEG, PNG and WebP textures unpack to full size on the graphics card, so their resolution and number decide memory, not the file size - see Model size and performance limits
  2. Enable Draco Compression

    • Often shrinks geometry by more than half
    • 3D Bits decodes Draco itself, so it works in every browser that shows the viewer
    • Decoding adds a little time, and the first Draco model also downloads the decoder; the smaller file usually more than makes up for it
  3. Remove Hidden Geometry

    • Delete faces not visible to camera
    • Remove internal components
    • Clean up mesh before export
  4. Optimize Materials

    • Share materials where possible
    • Remove unused textures
    • Use efficient texture formats

Target Sizes (advice, not limits):

  • Simple product: under 2 MB
  • Detailed product: 2-10 MB
  • Complex product: 10-20 MB - Composer starts warning at 20 MB
  • Above 30 MB a model does not load on iPhone Safari - see File Size Guidelines below

Check this guide for helpful tips


SPLAT Format​

File Extension: .splat
Best For: Gaussian splatting captures

About Gaussian Splatting​

A new 3D capture technique that creates photorealistic scenes from photos or videos using AI. Some of the apps you can use to create splats:

Check this tutorial on how to use 3DGS as variants

The best opensource editor for splats - Supersplat

Features​

Strength Photorealistic - Very high visual quality
Strength From Photos - Created from image sets
Strength Novel View Synthesis - Smooth viewing angles
Strength Swappable whole - a scan can still be shown or hidden by a rule, so several scans can stand in for each other as options

Limitations​

Limitation No material variants - nothing inside the file can be switched, so each alternative is a separate capture and a separate download
Limitation No Materials - Baked appearance
Limitation Large Files - 5-100 MB is typical straight out of a capture tool, so shrink them before you upload: crop away what is not the product, reduce the splat count, and export a compressed .ply, such as the one SuperSplat writes. 3D Bits takes .ply and .splat only, not .spz or .sog. Anything over 30 MB will not load at all on iPhone Safari
Limitation In active development - Some tools may lack support for splats
Limitation No Scene Lighting Interaction - SPLAT files are not affected by Composer scene lights and do not cast or receive shadows from the scene. However, if the original 3D scan captured lighting and shadows from the real environment, those will be preserved in the SPLAT file as part of the baked appearance

When to Use​

  • Suits Photorealistic room/environment captures
  • Suits Artistic/showcase purposes
  • Suits Experimental projects
  • Does not suit Product configurators (harder to configure efficiently)

STL Format​

File Extension: .stl
Best For: CAD exports, 3D printing

Features​

Strength CAD Compatibility - Standard CAD export
Strength Simple Geometry - Easy to work with
Strength Geometry only - nothing but triangles, so it is simple to produce, though with no compression a detailed part makes a large file

Limitations​

Limitation No Colors - Solid gray only
Limitation No Materials - No visual properties
Limitation No Textures - Can't apply images
Limitation Basic Display - Very plain appearance

When to Use​

  • Suits CAD model previews
  • Suits Technical drawings
  • Suits When visual quality doesn't matter
  • Does not suit Product visualization (use GLB with materials)

Adding Materials to STL​

STL files display as solid gray. To add materials:

  1. Import STL into Blender
  2. Apply materials and textures
  3. Export as GLB
  4. Use the GLB in Composer

PLY Format​

File Extension: .ply
Best For: Gaussian splat captures and scanner output

PLY comes in two quite different flavours and 3D Bits loads them through the same reader as .splat. A splat PLY behaves exactly like a .splat file. A scanner PLY with faces arrives as a mesh, coloured by its vertices rather than by materials. A PLY without faces arrives as a point cloud: unlit dots one pixel across, which can look sparse on a large screen.

Features​

Strength Direct from scanners and splat tools - no conversion step
Strength Colour without textures - point or vertex colour comes across

Limitations​

Limitation No material variants and no node control - it cannot be parsed into a structure
Limitation No materials to recolour or swap - what was captured is what you get
Limitation Large files - splat PLY in particular is rarely small, and the 30 MB block applies to it too

When to Use​

  • Suits A capture your scanning tool exports as PLY
  • Suits A quick look at scanner output before you commit to it
  • Does not suit A configurable product - convert to GLB and build the options there

OBJ Format​

File Extension: .obj
Best For: Legacy meshes you have nothing better for

OBJ loads, and that is close to the whole story. Its materials live in a separate .mtl file with its texture images beside it, which runs into exactly the hosting problem described for multi-file glTF in Adding Models - single-file storage gives every upload its own address, so those companions are not found. In practice an OBJ shows up as untextured geometry.

Limitations​

Limitation Materials arrive separately - and therefore usually not at all
Limitation No material variants and no node control
Limitation Verbose - a text format, so files are larger than the equivalent GLB

When to Use​

  • Suits A one-off look at some old geometry
  • Does not suit Anything on a product page - import it into Blender, give it materials, export GLB

Format Selection Guide​

For eCommerce Products → GLB​

Use GLB when you need:

  • Product configurators
  • Material variants
  • Node visibility control
  • Professional appearance
  • Fast loading times

For 3D Scans → SPLAT or GLB​

Use SPLAT:

  • For fast changing, hard to model products - sculptures, flower compositions
  • Shrink the capture first - crop it, thin it, export a compressed .ply
  • Photorealistic captures
  • Showcase projects
  • Experimental features

For Legacy Content → Convert to GLB​

OBJ, PLY and STL load directly, so this is a recommendation rather than a requirement. They carry no material variants and no node visibility control, which is what configurable products are built on, so converting is worth the effort for anything beyond a static preview.

If you have:

  • FBX files → Convert to GLB, this format is not loaded
  • GLTF folders with separate .bin and texture files → Convert to GLB, or host the whole folder yourself; uploaded one at a time the companion files cannot be found
  • STEP or STPZ files → Use Helpers → Converters
  • OBJ files → Loads, but convert to GLB for materials and variants
  • PLY files → Loads, but convert to GLB unless it is a Gaussian splat capture
  • STL files → Loads as plain grey geometry, add materials and convert to GLB

File Size Guidelines​

No format carries a size limit of its own - size is not a property of the format. There are two figures that actually stop something, and they are the same for every format:

  • 100 MB is the only size the app refuses. A larger file is stopped before it uploads: Composer says "File is too large - the maximum is 100 MB.", and the app's Assets page says "Could not start the upload". Separately, Shopify can refuse a GLB it cannot process, whatever its size - see Preparing GLTF Assets.
  • 30 MB is a storefront block rather than a maximum, and it applies on iPhone Safari only. See the admonition below.

Everything in between is advisory. Composer flags heavy files as you work, but nothing between the two figures above stops you saving, publishing or loading anything.

The column below is therefore the iPhone Safari ceiling, not a maximum:

FormatRecommendediPhone Safari ceilingNotes
GLB< 10 MB30 MBCompress textures and geometry
GLTF< 10 MB30 MBSelf-contained only - convert to GLB instead
SPLAT< 10 MB30 MBCrop and thin the capture, or export a compressed .ply; splats are rarely small
PLY< 10 MB30 MBSame reader as SPLAT, same advice
STL< 5 MB30 MBAdd materials, convert to GLB
OBJ< 5 MB30 MBConvert to GLB
30 MB is a hard block, not a guideline

On the storefront, 3D Bits refuses to load any single model over 30 MB on iPhone Safari, because those shoppers' browsers are the ones that crash. They see a panel explaining it and the rest of the scene loads without that model.

The limit is per model rather than per scene, so a scene of four 20 MB models loads and a scene of one 31 MB model does not. No other browser blocks on size, which means a file over the line is invisible to you until an iPhone shopper meets it.

Composer flags a file at 20 MB and again at 40 MB, and warns when every distinct file together passes 40 MB. Model size and performance limits sets out all four limits and what each one does.

Large Files

Well under the block, a heavy file still:

  • Takes very long to load
  • Causes memory issues
  • Fails on lower-end devices
  • Creates a poor user experience

Optimize or split into multiple models if needed.


For New Projects​

  1. Model in your preferred software (Blender, 3ds Max, etc.)
  2. Apply PBR materials (Metallic-Roughness workflow)
  3. Optimize geometry (reduce polygons, remove hidden parts)
  4. Compress textures (appropriate resolution)
  5. Export as GLB with Draco compression
  6. Test in Composer
  7. Optimize further if needed

For Existing Content​

  1. Identify current format (OBJ, FBX, etc.)
  2. Import into Blender or compatible software
  3. Set up PBR materials
  4. Export as GLB
  5. Test in Composer

STEP, IGES and BRep formats​

Start with the built-in converter. If what you have is a STEP (.step, .stp) or STPZ file, you do not need another tool: the 3D Bits app has a converter at Helpers → Converters that turns it into a GLB (binary glTF) file you download, then upload through Assets or Composer like any other model. It takes .step, .stp and .stpz files up to 200 MB, and the conversion runs in your browser, so the CAD file is not uploaded anywhere. Composer's start screen links straight to it - "Have a STEP or STPZ file? Go to the Converter to generate glTF." - and Helpers describes it.

Treat the result as a starting point rather than a finished asset. CAD carries far more detail than a product page needs, so the converted file usually wants a pass through Blender to reduce it and to group the parts the way your options need. Preparing 3D assets covers that pass.

For IGES, Parasolid and ACIS, and for a STEP file the converter cannot make sense of, take the manual route described below.

What are BRep models?
BRep (Boundary Representation) is a precise mathematical representation of 3D geometry used in CAD software. Unlike mesh-based formats (GLB, STL), BRep defines surfaces using mathematical curves and equations, making them perfect for engineering and manufacturing but incompatible with real-time 3D viewers that require polygon meshes.

Common BRep formats:

  • STEP (.step, .stp) - Industry standard for CAD exchange (created by SolidWorks, CATIA, Fusion 360, etc.)
  • IGES (.igs, .iges) - Older CAD exchange format
  • Parasolid (.x_t, .x_b) - Native format for Siemens NX, Solid Edge
  • ACIS (.sat) - Format used by AutoCAD, Inventor

Tools that create these files:

  • SolidWorks - Mechanical design CAD
  • CATIA - Advanced engineering CAD
  • Fusion 360 - Cloud-based CAD
  • Rhino - NURBS-based modeling
  • FreeCAD - Open-source parametric CAD
  • Siemens NX - Industrial CAD/CAM

The manual conversion workflow:

Never Upload Production CAD Files Directly

Production CAD files (STEP, IGES, etc.) often contain precise engineering data, manufacturing specifications, and proprietary information. Never convert and upload these directly to your website. Always create simplified, marketing-quality versions that show product appearance without revealing sensitive technical details.

Read: Your Assets & Security - Essential Information

BRep formats cannot be directly loaded into Composer. They must be tessellated (converted from mathematical surfaces to polygon meshes) first:

  1. Tessellate in CAD software - Open the STEP/IGES file in tools like:
    • FreeCAD (free, open-source)
    • Rhino (paid, excellent tessellation control)
    • Original CAD software (SolidWorks, Fusion 360, etc.)
Tessellation Strategy Matters

Tessellation settings directly impact triangle count. CAD models can easily generate millions of triangles with high-quality settings, creating files too heavy for web use. For eCommerce, start from 50,000-500,000 triangles per model and go higher only where the product needs it. Use coarser tessellation settings, then manually add detail only where visible. Test file size and loading performance. Web models must remain lightweight for a smooth shopper experience.

  1. Export as mesh - Save as OBJ or STL from the CAD tool

  2. Import to Blender - Load the mesh, merge/clean geometry

  3. Apply materials & textures - Add PBR materials for realistic appearance

  4. Export as GLB - Final format for Composer

Check this tutorial to learn conversion principles between STEP and GLB

Learn More about 3D assets & configurators


Next Steps​

Now that you understand file formats:

Verified against the product in November 2026