Latest news
TutorialsUnreal Engine

Manage Materials Together with Material Parameter Collections in Unreal Engine

Based on the Unreal Engine 4.27 documentation, this guide walks through creating a Material Parameter Collection and using it to manage the appearance of multiple materials.

A contemporary interior visualization designed with shared color valuesAI image
Representative image, generated with AI.Image: 3dsınıfı / FCA AI

In brief

  1. A Material Parameter Collection stores scalar and vector parameters that materials can share.
  2. The example uses a scalar parameter named Global_Desaturation to change material color saturation.
  3. A Material can reference up to two different Material Parameter Collections.
  4. You can change collection values at runtime through Blueprint.

What will you learn in this guide?

When many materials in the same Unreal Engine scene need to respond to a shared value, managing parameters individually in each Material Instance can become cumbersome. A Material Parameter Collection (MPC) stores scalar and vector values in a single asset and lets multiple Materials use them.

In this example, you’ll create a scalar parameter and use it to control color saturation in a simple material. Then you’ll see how to change the same value through Blueprint. This shows how a single collection value can affect every material that uses it.

Requirements

This guide follows the workflow in the official Material Parameter Collections documentation for Unreal Engine 4.27. The source does not specify any additional account requirements or special hardware for this exercise. You’ll need a project in the editor, a content area to work in within the Content Browser, and objects with materials applied in the scene so you can observe the changes.

The example parameter will be named Global_Desaturation. This name is used throughout the guide to match the scalar value in the collection with the collection parameter used in the Material graph. If you choose a different name, make sure the parameter names in the collection, Material, and Blueprint match.

Step by step: Create a collection and material

  1. Create a Material Parameter Collection asset. Right-click an empty area in the Content Browser. In the menu that opens, select Material Parameter Collection under Materials & Textures. Give the new asset a descriptive name.

  2. Add a scalar parameter to the collection. Double-click the asset to open its editor. Use the add button in the Scalar Parameters section to create a new value, and name it Global_Desaturation. Leave its default value at 0.0 for this example. Vector parameters can also be stored in the same type of collection; this exercise uses only a scalar value.

  3. Prepare a simple Material for testing. Create a new Material and add parameter nodes to its graph so you can adjust surface values such as base color, metallic, and roughness. The example in the guide uses parameters named Base_Color, Metallic, and Roughness for these inputs. The Material’s visual result should be easy to see on the scene objects you’ll use to test the collection value.

  4. Connect the collection value to the graph. Add a Desaturation node to the Material graph. Then drag the collection asset from the Content Browser into the graph to add a node that uses a collection parameter. Connect the Base_Color output to the first input of the Desaturation node, and connect the collection parameter output to the Fraction input. Connect the Desaturation output to the Material’s Base Color input, then compile the Material.

  5. Test the Material in the scene. Apply the Material you created to objects in the scene. Open the collection asset from the Content Browser and change the Global_Desaturation value from 0 to 1. In the source example, this change turns blue objects toward white. The goal is to observe how a single collection value can affect the appearance of materials linked to that collection.

Change the value at runtime with Blueprint

You don’t have to change the collection value only in the asset editor. The official example does this from within Blueprint. First, create a few Material Instances from the base Material and apply them to objects in the scene. The example uses red, green, and blue instances; the different colors make it easier to compare the change.

Open the Level Blueprint and specify the collection and the Global_Desaturation parameter name for the Set Scalar Parameter Value node. The documented workflow uses a Timeline to change the value over time: add two keys to the Float Track, with time 0 and value 0, then time 1 and value 1. The track is named Des_Amount in the example. After connecting the nodes, compile the Blueprint and run the scene. In the example, holding down the left mouse button turns the materials gray; releasing it restores their original colors.

Common mistakes and limitations

  • Not matching names: The parameter name selected in Blueprint must match the name in the collection. If you rename the parameter, you’ll need to assign the new name in the Blueprint that uses it.

  • Skipping compilation: Apply changes after modifying connections in the Material graph, and compile after editing a Blueprint.

  • Creating unnecessary collections: A Material can reference up to two different Material Parameter Collections. The documentation notes that one can be used for global values and the other for level-specific values.

  • Adding many values later: A collection can contain up to 1,024 scalar and 1,024 vector parameters. Changing the number of parameters in a collection causes Materials that reference it to be recompiled. If you need many parameters, planning them in advance may be more efficient.

Impact on architectural visualization workflows

Architectural presentations can contain many objects that share the same material language. The collection approach makes it possible to manage settings from one place in scenes where materials need to follow a shared scalar or vector value, for example. You can also link a value change through Blueprint to an interaction in the scene. However, this doesn’t mean every visual requirement should automatically be moved into a collection; decide early in the project which values should be shared and which should remain material-specific.

Next steps

Start by setting up the example in a small test scene and verifying how one parameter affects multiple materials. Then consider organizing shared project values and values that need to change by level in separate collections. Check parameter names on the Blueprint side, and after renaming, make sure the relevant nodes are still connected to the correct value.

Source and license

This guide is adapted into Turkish from Epic Games’ official Material Parameter Collections documentation for Unreal Engine 4.27. The source is listed as free in the license field.

Sources

1 source
D
dev.epicgames.comdev.epicgames.com/documentation/en-us/unreal-engine/material-parameter-collections
Summary

Source texts are not republished; short quotes are marked, everything else is our own summary and commentary.

3dsınıfı’s take
3dEditor’s assessment

For architecture firms and visualization teams in Turkey, the practical value of this method lies in managing a shared material response across many objects from one place. It can reduce repetitive parameter adjustments, especially when preparing scene variations or interactive presentations.

Since the source provides no specific hardware or pricing information, it would be misleading to infer purchase or performance benefits. Before using the method, check the Unreal Engine version in use and the structure of the existing project; design collections with the two-reference limit in mind, and consider how parameter names affect Blueprint connections.

Frequently asked questions

What is a Material Parameter Collection in Unreal Engine used for?

It stores scalar and vector parameters in one asset and allows multiple Materials to use those values.

How many Material Parameter Collections can a Material use?

The official documentation states that a Material can reference up to two different Material Parameter Collections.

Can a Material Parameter Collection value be changed with Blueprint?

Yes. The documentation shows how to change a scalar value in a collection from Blueprint using the Set Scalar Parameter Value node.

Comments and the forum are in Turkish.Join the discussion
+

Related news