> For the complete documentation index, see [llms.txt](https://docs.icraft.design/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.icraft.design/editor-features/model-processing/model-optimization.md).

# Model Optimization

Model Optimization is an online geometry and structure optimization tool provided by iCraft. It significantly reduces model complexity and improves real-time rendering performance while preserving visual quality as much as possible.With Model Optimization, you can:

* Reduce triangle count
* Merge meshes
* Clean up redundant hierarchical structures
* Perform automatic decimation
* Correct scaling
* Unify materials and geometry structure
* Improve frame rate and loading speed
* Prepare models for deployment on the web, mobile, digital twin, and presentation scenes

This tool supports direct in-browser model processing with no additional software installation, and is completely free and public to all users.All optimization processes run **locally in the user’s browser**; model files are **not uploaded** to official servers, ensuring user data privacy and security. It is both convenient and reliable.

***

## Model Optimization Workflow

{% stepper %}
{% step %}

#### Import Model

Click the **Import** button or drag-and-drop to upload GLB/GLTF files. Once imported, the page displays a 3D preview and model structure information.
{% endstep %}

{% step %}

#### Review Performance Data

Focus on the following metrics to determine whether optimization is needed and whether bottlenecks stem from geometry or structure:

* Is the triangle count excessively high?
* Is the FPS low?
* Is the number of geometries too large?
* Are the draw call counts abnormal?
* Is memory usage too high?
  {% endstep %}

{% step %}

#### Perform Optimization

The recommended order is:

1. **Hierarchy Optimization**: Clean up redundant empty nodes and merge meaningless groups for a cleaner structure.
2. **Merge Meshes**: Combine fragmented geometries to reduce draw calls and improve rendering efficiency.
3. **Automatic Decimation**: Intelligently reduce polygon count while preserving overall contours.
4. **Scale Correction**: Unify model scale to avoid abnormally large or small models.
   {% endstep %}

{% step %}

#### Check Optimization Results

After optimization, the system updates the model preview in real time and refreshes performance metrics.At this stage, carefully verify:

**Visual Integrity**

Check for missing geometry, broken faces, local collapse, obvious aliasing, misaligned components, over-simplified details, abnormal materials, or flickering.

**Performance Metrics**

Compare pre- and post-optimization data in the bottom-left corner of the preview window:

* Reduced triangle count
* Fewer geometries
* Lower draw calls
* Higher FPS
* Lower memory usage
  {% endstep %}

{% step %}

#### Export Model

Once finished, click **Export** in the top-right corner. You may enable **Fast Compress Model** during export, then download the optimized file locally.
{% endstep %}
{% endstepper %}

![](/files/hvXAaS8sxl89vH5tnUbL)

***

## Practical Tips

* Start with **hierarchy optimization + mesh merging**, then use automatic decimation.
* Compare results during optimization by monitoring FPS, memory usage, and triangle count.
* For engineering models, prioritize structural cleanup.
* Optimize carefully; avoid excessive decimation on critical components.
* Always keep a backup of the original file.
* For extremely large models, perform basic simplification first before optimization or compression.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.icraft.design/editor-features/model-processing/model-optimization.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.