> For the complete documentation index, see [llms.txt](https://docs.varbase.vardot.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.varbase.vardot.com/developers/faqs.md).

# Frequently Asked Questions (FAQs)

Common questions and answers about Varbase 11.0.x.

***

## What is the difference between Varbase 10.x and 11.x?

The most significant difference is the shift from a **module-based architecture** to a **recipe-based architecture**.

In Varbase 10.x, functionality was provided through custom Varbase modules (such as `varbase_core`, `varbase_media`, `varbase_editor`) that were installed via a Drupal installation profile. In Varbase 11.x, these modules have been replaced by **Drupal recipes** (such as `varbase_content_base`, `varbase_media_base`, `varbase_editor_base`) that are applied to a standard Drupal site.

Other key differences include:

* **Drupal version**: Varbase 10.x is built on Drupal 10; Varbase 11.x is built on Drupal 11.
* **PHP requirement**: Varbase 11.x runs on Drupal core 11.4, which requires PHP 8.3 or later; PHP 8.4 is recommended.
* **Email handling**: Varbase Email module has been replaced by Easy Email recipes.
* **Workflow automation**: ECA (Event-Condition-Action) is now used for workflow automation.
* **Theme system**: Vartheme BS5 now uses Single Directory Components (SDC) and CVA.

***

## How do I apply a single Varbase recipe?

Most Varbase recipes already ship in the project's `recipes/` folder. Apply one with Drush:

```bash
ddev drush recipe ../recipes/varbase_i18n_base
```

If the recipe is not in `recipes/` yet, require it with Composer first, then apply it:

```bash
ddev composer require drupal/varbase_news_base
ddev drush recipe ../recipes/varbase_news_base
```

See [Module and Recipe Inventory](https://docs.varbase.vardot.com/developers/understanding-varbase/module-and-recipe-inventory.md) for which recipes ship with the project.

***

## Can I use Varbase recipes without the full distribution?

Yes. Varbase 11.x recipes are designed to be composable and can be applied individually to any Drupal 11 site. You do not need to use the full Varbase Starter recipe or the Varbase project template.

For example, if you only need Varbase's media handling, you can apply just the `varbase_media_base` recipe to your existing Drupal site. The recipe will install the necessary modules and apply the appropriate configuration.

Each recipe declares its own dependencies, so applying a recipe will automatically apply any prerequisite recipes as well.

***

## How do I update from Varbase 10.x to 11.x?

No in-place upgrade path from Varbase 10.x to Varbase 11.x is published. The shift from Varbase modules to recipes changes how the site is built, so the recommended approach is to start a new Varbase 11.x site and migrate your content with Drupal's Migrate API or another migration tool.

See [Updating Varbase](https://docs.varbase.vardot.com/developers/updating-varbase.md) for updates within Varbase 11.0.x.

***

## Where do I report bugs?

Bugs and issues for Varbase should be reported on the **Drupal.org issue queue**:

* **Varbase project**: <https://www.drupal.org/project/issues/varbase>
* **Individual Varbase recipes**: Each recipe has its own issue queue on Drupal.org. Navigate to the recipe's project page and use the "Issues" tab.

When reporting a bug, please include:

* The Varbase version and Drupal version you are using.
* Steps to reproduce the issue.
* Expected behavior versus actual behavior.
* Any error messages from the Drupal log (Reports > Recent log messages).
* Your PHP version and hosting environment details.

***

## Something on my new Varbase 11 site looks broken. Is it a known issue?

Check [Known Issues on a New Varbase 11 Site](https://docs.varbase.vardot.com/developers/known-issues-on-a-new-varbase-11-site.md) first. It lists the configuration and behaviour issues found on one Varbase 11.0.0 site with Varbase Starter, such as the empty **Moderated content** list, media types missing from **Insert Media**, the closed `/form/contact` webform and the unpublished **Privacy policy** page, with the cause and a fix for each. Check each one on your own site before you change anything, and report what you confirm on the issue queue of the recipe that ships it.

***

## How do I install Varbase?

The recommended way to install Varbase 11.x is using DDEV:

```bash
mkdir my_varbase_site
cd my_varbase_site
ddev config --project-type=drupal11 --docroot=web --php-version=8.4
ddev start
ddev composer create-project "drupal/varbase_project:~11.0.0"
ddev launch
```

The **Varbase Installer** handles Drupal installation and recipe application automatically.

For detailed installation instructions, see the [Installing Varbase](https://docs.varbase.vardot.com/developers/installing-varbase.md) section.

***

## What PHP version does Varbase 11.x require?

Varbase 11.0.x runs on Drupal core `~11.4.0`, which requires **PHP 8.3** or later. **PHP 8.4** is recommended and is what the DDEV setup in these docs uses. See [Requirements](https://docs.varbase.vardot.com/developers/installing-varbase/requirements.md).

***

## Can I use a different front-end theme?

Yes. While Vartheme BS5 is the default front-end theme, you can use any Drupal-compatible theme. You can:

* Create a **sub-theme** of Vartheme BS5 to customize it (recommended for most projects).
* Install a completely different contributed theme.
* Create a custom theme from scratch.

See the [Theme Development with Varbase](https://docs.varbase.vardot.com/developers/theme-development-with-varbase.md) section for more details.

***

## How do I customize emails sent from the site?

Varbase 11.x uses Easy Email for email management. You can customize email templates through the admin interface:

1. Navigate to **Structure > Email templates** (`/admin/structure/email-templates/templates`).
2. Edit the template you want to customize.
3. Modify the subject, body, and other fields.
4. Save the template.

For SMTP configuration, see [Configure Easy Email](https://docs.varbase.vardot.com/developers/configuring-a-varbase-site/mailer-settings/configure-easy-email.md).

***

## How do I add a new content type?

You can add content types through the Drupal admin interface:

1. Navigate to **Structure > Content types**.
2. Click **Add content type**.
3. Configure the content type settings and fields.
4. Save.

For a reusable approach, consider creating a custom recipe that defines the content type. See [Creating Your Own Recipe](https://docs.varbase.vardot.com/developers/extending-varbase/creating-your-own-recipe.md).
