# Grid Array

The **Grid Array** operator arranges selected mesh objects into a grid in the X and Y axis. When clicked, you will be shown the redo panel where you can modify the different properties or settings to edit the result of the grid array arrangement of the selected objects.

<figure><img src="/files/boeNRdBGLoUoRLnT2ru8" alt=""><figcaption><p>Figure 1</p></figcaption></figure>

This needs two or more selected objects in order to work. It will also require and active object in the selection or it can produce an error when using the **Active Sort** method. The active object is usually the last one in the selection order and is highlighted in a different color than the rest.

<figure><img src="/files/M5QrhKmrpi6IM5Unh3EV" alt=""><figcaption><p>Figure 2</p></figcaption></figure>

In Figure 2, when the selection has no active object, you can just select on them to make them the active object. The highlight color for the selected objects depends on the Blender theme that you are using.

Here are the redo properties and what they do:

### Sort

This determines the sort method when arranging the 3D models into a grid.

<figure><img src="/files/s7O9zyq4V65ALlLFDRlY" alt=""><figcaption><p>Figure 3</p></figcaption></figure>

* **Active** : This arranges the selected objects into a grid with the active object placed in the first row and column. There is no special sort method used for the rest of the selected objects.
* **Name** : This sorts the selected objects based on their name in the ascending order.
* **Smallest** : This sorts the selected objects from the smallest to the biggest. The size is based on their dimension.
* **Biggest** : This sorts the selected objets from the biggest to the smallest. The size is based on their dimension.
* **Random** : This sorts the selected objects in random. The result of the randomization can be controlled using a random seed property which appears when this **Sort** method is selected.

{% hint style="info" %}
*The location of the active object selected will be used to position the first row and column of the grid array.*
{% endhint %}

### Seed

This will only appear when the Random Sort method is used and will let you choose the randomization pattern you want.

### Offset

This will let you offset or crate a margin for the arranged objects in the X and Y axis.

<figure><img src="/files/Dfg7yKBJ8N4u38jLiuvL" alt=""><figcaption><p>Figure 4</p></figcaption></figure>

### Steps

This determines the number of objects that can be placed in a row or column based on their total number.

<figure><img src="/files/tPWux8W7xP3luC7eRp74" alt=""><figcaption><p>Figure 5</p></figcaption></figure>

### Location

This determines the direction of the rows and columns which can be represented by the X and Y axis respectively.

<figure><img src="/files/2S91dA6ZcvcgC9GLOVz5" alt=""><figcaption><p>Figure 6</p></figcaption></figure>

The main inspiration for this operator are the 3D model sets I see online being sold. They are arranged neatly in a grid and I wanted my own tool make it easier for me to achieve the same effect.


---

# 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://www.blenderguppy.com/add-ons/sort-asset/functions/grid-array.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.