> ## Documentation Index
> Fetch the complete documentation index at: https://developer.lulacommerce.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Modifier Group

> This endpoint creates a new modifier group for a store. Modifier groups allow you to organize customization options that can be applied to menu items.

This endpoint creates a new modifier group that can be used to organize customization options for your menu items. Modifier groups define the rules and constraints for how customers can customize their orders.

<Note>
  Modifier groups are essential for managing product customizations like sizes, add-ons, and variations.
</Note>

### Body

<ParamField body="name" type="string" required>
  Name of the modifier group. Example: "MG007"
</ParamField>

<ParamField body="description" type="string" required>
  Description of the modifier group. Example: "Modifier group for drinks"
</ParamField>

<ParamField body="store_id" type="string" required>
  The unique identifier of the store
</ParamField>

<ParamField body="min_quantity" type="number" required>
  Minimum number of options customer must select
</ParamField>

<ParamField body="max_quantity" type="number" required>
  Maximum number of options customer can select
</ParamField>

<ParamField body="precedence" type="number" default={0}>
  Display order precedence for the modifier group
</ParamField>

<ParamField body="option_type" type="string" required>
  Type of options in this group. Example: "Customization"
</ParamField>

<ParamField body="max_free_options" type="number" default={0}>
  Maximum number of free options allowed
</ParamField>

<ParamField body="max_options_qty" type="number" required>
  Maximum quantity for each option
</ParamField>

<ParamField body="status" type="string" required>
  Status of the modifier group. Values: "active" or "inactive"
</ParamField>

<ParamField body="modifier_options" type="array">
  Array of modifier option IDs to associate with this group
</ParamField>

<ParamField body="linked_store_items" type="array">
  Array of store item IDs to link with this modifier group
</ParamField>

### Request Example

```json theme={null}
{
  "name": "MG007",
  "description": "Modifier group for drinks",
  "store_id": "449235c1-3d04-4519-998b-40d2a621e5e0",
  "min_quantity": 0,
  "max_quantity": 2,
  "precedence": 0,
  "option_type": "Customization",
  "max_free_options": 0,
  "max_options_qty": 2,
  "status": "active",
  "modifier_options": ["2edc15af-2552-45a2-a149-d670279e27f3","cfb70950-996e-4dd4-8b43-60b86fb9cc17"],
  "linked_store_items": ["3dbe1e78-c746-4940-8db8-ef468c738324","3dbe1e78-c746-4940-8db8-ef468c738324"]
}
```

### Response

<Note>
  This endpoint processes the request and creates the modifier group. No response body is provided upon successful creation.
</Note>

<Tip>
  Use modifier groups to organize related customization options like "Size Options", "Add-ons", or "Preparation Methods".
</Tip>

<Warning>
  Ensure that min\_quantity is not greater than max\_quantity, and that the linked store items exist in your inventory.
</Warning>