Material Swaps

Material swaps let you define workspace-wide rules that automatically replace materials when models load in the studio or run through pipelines. Instead of manually calibrating the same material on every model, you set it once and it applies everywhere.

How it works

Each rule has three parts:

• Match text — The name (or partial name) to look for in a model's material groups.
• Match mode — Either Contains (matches if the group name includes the text) or Exact (matches only if the full name matches).
• Replacement material — The material from your workspace library to apply when a match is found.

When a model loads, Glossi checks each material group against your rules in priority order. The first matching rule wins for each group. If a material group has already been manually calibrated (saved to the project), the swap rule is skipped for that group.

Setting up rules

1. Go to Settings → Workspace.
2. Find the Material Swaps section.
3. Click Add Rule (or Manage Rules if rules already exist).
4. In the modal:
   • Type a material group name in the text field (e.g., "Leather", "Chrome", "Fabric").
   • Toggle between Contains and Exact matching.
   • Click the material picker to choose a replacement material from your library.
5. Add more rules as needed. Use the arrows to reorder — rules are evaluated top to bottom.
6. Click Save.

Priority and ordering

Rules are evaluated in the order shown in the modal (top to bottom). If two rules could both match the same material group, the one listed first wins. You can reorder rules using the up/down arrows.

Manual overrides

If you've manually calibrated a material in the studio and saved the project, that calibration takes priority over workspace swap rules. This means you can set workspace-wide defaults and still fine-tune individual projects without the swap rule overriding your work.

Where swaps apply

• Studio — Swap rules run automatically when a model finishes loading. You'll see the materials update in the viewport.
• Pipelines — When models are processed through automated pipelines, swap rules are applied before rendering.
• API renders — Models rendered via the REST API also respect workspace swap rules.

Tips

• Use Contains mode for broad rules (e.g., "leather" matches "Upper Leather", "Leather Panel", "leather_trim").
• Use Exact mode when you need precision and don't want partial matches.
• Matching is case-insensitive and treats underscores as spaces, so "chrome_trim" matches "Chrome Trim".
• Upload your standard materials to the workspace library first, then reference them in swap rules.