# Apply materials across models

URL: https://docs.glossi.io/set-up-the-product/materials-across-models

Replace a material on many models at once by slot name, or set up workspace rules that swap materials automatically.

When several models share material slot names, such as `upper_leather` or `sole`, you can change those slots on all of them at once instead of opening each model. Use **Replace materials** for a one-off change to a set of models, and workspace **Material Swaps** rules for a change that should apply every time a model loads.

Both match slots by name, so they only work as well as the slot names in your source files. `Upper Leather` and `upper_leather` match each other. A name such as `Material.003` does not describe a part, so rename it in your 3D tool or with [model prep](https://docs.glossi.io/bring-in-your-product/prepare-a-model.md) first.

## Replace materials on several models

1. Open **Models** and select the models to change.
2. Choose **Replace materials** in the selection bar.
3. Check the scope at the top: **Selected**, **Tagged**, or **All models**.
4. Enter the slot name to match, or pick one from **Pick a material slot**.
5. Set the match mode. **Contains** matches any slot whose name includes the text. **Exact** matches only a slot with that exact name.
6. Choose the material to use. The picker shows **Yours** and **From catalog**.
7. Add more rows for other slots if needed.
8. Check the count of matching material slots, then choose **Replace on N models**.
9. Choose **Confirm replacement**.

You can also open the same tool with **Apply materials** from a model's details, or from a material's page to use that material.

Start with a few models from each product family and check them in the [Studio](https://docs.glossi.io/studio/product-and-materials.md) before you widen the scope. A high match count does not prove the right slots matched.

To repeat the same change on new models later, choose **Save as automation** instead of applying it. Automations are available on Enterprise.

## Add colorways to several models

The same tool has a second mode, **Add colorways** (**Add finishes** in automotive and industrial workspaces). It builds a grid: each column is a material slot, each row is a named colorway, and each cell is the material that slot wears in that colorway. Choose **Save** to add the colorways to every model in scope.

For one model, [create variants on the model page](https://docs.glossi.io/set-up-the-product/variants.md) instead. It shows each variant's preview and logos.

## Set workspace material rules

Material Swaps rules replace materials by slot name automatically when a model loads in the Studio or runs through an automation.

> Only workspace admins see **Material Swaps**.

1. Open **Settings**, then **Workspace**.
2. In **Material Swaps**, choose **Add Rule** (or **Manage Rules** if rules exist).
3. Enter the slot name to match, for example `upper_leather`.
4. Choose **Contains** or **Exact**.
5. Choose the replacement material.
6. Choose **Add rule** for each further rule.
7. Order the rules with the up and down arrows.
8. Choose **Save rules**.

Rules run in order, and when two rules match the same slot, the earlier one wins. Put narrow rules, such as an exact name, above broad **Contains** rules.

After saving, open a model from each product family in the Studio and check the result: the right slots changed, nothing else did, and texture scale and transparent or metal surfaces look correct.

## Related

* [Create product variants](https://docs.glossi.io/set-up-the-product/variants.md)
* [Materials](https://docs.glossi.io/library/materials.md)
* [Edit product materials](https://docs.glossi.io/studio/product-and-materials.md)
* [Automation steps](https://docs.glossi.io/repeat-at-scale/automations/steps.md)