---
title: Installation
date: 2026-06-28T22:16:00+01:00
author: John Henry Donovan
canonical_url: "https://johnhenry.ie/plugins/bundle-builder/docs/getting-started/installation"
section: Plugins
---
esc

↑↓ to navigate↵ to selectesc to close

Menu On this page 

- [Return to top](#)

Documentation

Documentation

# Installation

## **Requirements**

- Craft CMS 5.0+
- Craft Commerce 5.0+
- PHP 8.2+

## Install using Composer

```bash
# go to the project directory
cd /path/to/my-project

# tell Composer to load the plugin
composer require johnhenry/craft-bundle-builder

# tell Craft to install the plugin
./craft plugin/install craft-bundle-builder
```

## Install using DDEV

```bash
ddev composer require "johnhenry/craft-bundle-builder:^1.0.0" -w && ddev craft plugin/install bundle-builder
```

## Install from the Plugin Store

Go to the Plugin Store in your project’s Control Panel and search for “Bundle Builder”. Then press “Install”.

## What the install does

The install migration:

- Creates the plugin's tables (`bundlebuilder_bundletypes`, `bundlebuilder_bundletypes_sites`, `bundlebuilder_bundles`, `bundlebuilder_products`).
- Creates a zero-rate **“Bundle (apportioned)”** tax category used by *multiple supply* bundles (see [Tax Treatment](http://localhost:5174/bundle-builder/guide/vat.html)).

## After installing

1. Create a [bundle type](https://johnhenry.ie/plugins/bundle-builder/docs/getting-started/bundle-types) under **Bundles → Bundle Types**.
2. Create your first [bundle](https://johnhenry.ie/plugins/bundle-builder/docs/guide/creating-bundles).

## Permissions

Each bundle type has its own **“Manage ‘{type}’ bundles”** permission. Managing bundle *types* themselves requires an admin account.

On this page