# Patterns

The **Patterns** option set in Simplio3D allows vector-based designs (SVG files) to be applied to 3D models. This feature enables advanced surface customization and is particularly useful for industries where product appearance is a key factor. This can be applied to jersey designs, apparel patterns, custom packaging and sports gear customization.

{% hint style="info" %}
**Before starting the next steps, ensure that a correct** [**3D model**](/getting-started/prepare-3d-models.md) **is uploaded to the system and that a configurator is created in the** [**Products**](/learning-the-app/products.md) **section.**
{% endhint %}

#### SVG (Vector-Based Patterns)

Vector patterns must first be uploaded in the **Materials** section in [**SVG**](/learning-the-app/materials/svg.md). The process follows the same steps as uploading [textures](/learning-the-app/materials/textures.md). Once uploaded, SVG files can be previewed, and the system automatically detects the color channels within the file. These channels can be renamed for clarity. SVG files can also be organized into categories, ensuring easier management when working with multiple designs.

#### Adding a Pattern Block and Defining Variants

To add a Pattern block, navigate to the **Create Options** tab and from the dropdown menu, choose **Patterns** and then click 'Add block' button.

<figure><img src="/files/Fd4cmdEMWAz9WFGIyy4z" alt=""><figcaption></figcaption></figure>

Variants represent the different designs within a Patterns block. To add one, click **Add Variant**.

<figure><img src="/files/GxIeh2emQ7e4SvH8tJ7h" alt=""><figcaption></figcaption></figure>

A popup window will appear where you must provide a **Title** (the visible name for customers) and a **Variant Name** (used internally).&#x20;

<figure><img src="/files/kAQxcMLxtrSQZXrZANYi" alt=""><figcaption></figcaption></figure>

You then select the **3D model and parts** where the pattern will be applied, followed by choosing the **vector pattern (SVG)** from your Materials > SVG.

<figure><img src="/files/yKZZUkWiVGkJ33fwNXmL" alt=""><figcaption></figcaption></figure>

Each variant includes pattern **Settings** that define its behavior. Users can select a **color category** to import color palettes, similar to the Text option set. It is also possible to enable or disable transformations such as **Move, Scale, Rotate, and Mirror**. Additionally, a **Color Picker** can be enabled, allowing customers to modify the colors of the SVG design directly in the configurator. In this case, I will just enable the **Custom color**.

<figure><img src="/files/5OS2k0qk5w1IaPIqIynr" alt=""><figcaption></figcaption></figure>

Click 'Save' to add your first Pattern variant. Add a thumbnail image with the pattern variant in the similar way we do with [Thumbnail](/learning-the-app/products/create-options/thumbnails.md) option blocks.&#x20;

<figure><img src="/files/jUoCvhleu8tSrzqfN0Jm" alt=""><figcaption></figcaption></figure>

You can repeat this process by adding more pattern variants.

<figure><img src="/files/9wHllPc1GPA9NY6wD9Cz" alt=""><figcaption></figcaption></figure>

Click 'Save' to add the Pattern block. After defining the necessary variants, launch the configurator by clicking the **Preview** button to test the Pattern block. This preview allows verification of how patterns are applied to the 3D model and ensures that transformations such as scaling, rotation, and mirroring function correctly. The preview also provides the opportunity to test the color customization options before publishing the configurator to end users.

<figure><img src="/files/5pWbfcQcAY1ccF5ptKOQ" alt=""><figcaption></figcaption></figure>

The **Patterns module** extends Simplio3D’s customization capabilities by allowing vector-based surface designs to be applied directly to 3D products. With precise control over placement, transformation, and color customization, the module provides both flexibility for customers and efficiency for production workflows.


---

# Agent Instructions: 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:

```
GET https://docs.simplio3d.com/learning-the-app/products/create-options/patterns.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.