An install profile is a folder with a .info.yml file of type profile that the installer uses to set up a new site. A distribution is an install profile whose info file has a distribution key, which makes the installer pick it automatically and show its name instead of Drupal.
' - '@type': Question name: 'Is Drupal CMS a distribution?' acceptedAnswer: '@type': Answer text: 'Its installer, drupal_cms_installer, is an install profile whose info file in release 2.2.7 has a distribution key with the name Drupal CMS. The drupal.org project page calls Drupal CMS a platform built on Drupal core.
' - '@type': Question name: 'How is a distribution different from a recipe?' acceptedAnswer: '@type': Answer text: 'A distribution is chosen once, when the site is installed. The drupal.org recipes initiative page lists its drawbacks: hard to keep updated, impossible to add after a project starts, not easy to remove, and impossible to mix with other functionality. A recipe can be applied at any point in the life of a site and can build on other recipes.
' - '@type': Question name: 'Where do I find Drupal distributions?' acceptedAnswer: '@type': Answer text: 'On the drupal.org Distributions page. It lists them with filters for maintenance status, development status, stability and security advisory coverage, and sorts by criteria such as most installed or last release.
' - '@type': TechArticle headline: Distribution description: 'A Drupal distribution is Drupal core bundled with modules, themes and configuration for one kind of site, installed through an install profile.' image: '@type': ImageObject url: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg' width: '1200' height: '630' datePublished: '2026-10-26T18:01:04+0000' dateModified: '2026-10-26T18:01:04+0000' author: '@type': Organization '@id': 'https://dxpr.com/#organization' name: DXPR url: 'https://dxpr.com/' logo: '@type': ImageObject url: 'https://dxpr.com/themes/custom/dxpr_com/dxpr-logo-dark.svg' width: '1348' height: '501' publisher: '@type': Organization '@id': 'https://dxpr.com/#organization' name: DXPR url: 'https://dxpr.com/' logo: '@type': ImageObject url: 'https://dxpr.com/themes/custom/dxpr_com/dxpr-logo-dark.svg' width: '1348' height: '501' mainEntityOfPage: 'https://dxpr.com/hc/documentation/learn-drupal/drupal-glossary/distribution' articleSection: 'Drupal glossary' - '@type': WebPage '@id': 'https://dxpr.com/hc/documentation/learn-drupal/drupal-glossary/distribution' description: 'A Drupal distribution is Drupal core bundled with modules, themes and configuration for one kind of site, installed through an install profile.' breadcrumb: '@type': BreadcrumbList itemListElement: - '@type': ListItem position: 1 name: Home item: 'https://dxpr.com/' publisher: '@type': Organization '@id': 'https://dxpr.com/#organization' name: DXPR inLanguage: en --- [Help Center](/hc)/[Documentation](/hc/documentation) /[Learn Drupal](/hc/documentation/learn-drupal) /[Drupal glossary](/hc/documentation/learn-drupal/drupal-glossary) # Distribution A Drupal distribution is Drupal core bundled with modules, themes and configuration for one kind of site, installed through an install profile. Learn DrupalDrupal glossary Last updated October 26, 2026 ## In this guide Related terms - [Install profile](/hc/documentation/learn-drupal/drupal-glossary/install-profile) - [Recipes](/hc/documentation/learn-drupal/drupal-glossary/recipes) - [Drupal CMS](/hc/documentation/learn-drupal/drupal-glossary/drupal-cms) - [Module](/hc/documentation/learn-drupal/drupal-glossary/module) - [Composer](/hc/documentation/learn-drupal/drupal-glossary/composer) - [Core](/hc/documentation/learn-drupal/drupal-glossary/core) [All Drupal terms from A to Z](/hc/documentation/learn-drupal/drupal-glossary) A distribution is a packaged way to start a Drupal site. It begins as an install profile, a folder with a `.info.yml` file of type `profile`. It becomes a distribution when that file carries a `distribution` key. The installer then chooses the profile without asking and shows the distribution's name instead of the word Drupal. ## How distributions work in Drupal 11 The drupal.org page for distributions describes them as a single download with Drupal core, contributed modules, themes and pre-defined configuration, aimed at a specific type of site. The mechanism is in core. In Drupal 11.4.10, `_install_select_profile()` picks a profile in this order: the only profile available, a profile requested in the install parameters, the first profile marked as a distribution, and then the only visible profile. `InstallerKernel` also selects the first profile whose info has a `distribution` key. The `distribution` key has these parts in the 11.4.10 code: `name`, which replaces "Drupal" in the installer, `langcode`, and under `install`, the `theme` used during installation and a `finish_url` where the installer redirects when it is done. Core's own profiles, `standard`, `minimal` and `demo_umami`, are not distributions. Drush follows the same rule. The `site:install` argument accepts an install profile name or a path to a [recipe](/hc/documentation/learn-drupal/drupal-glossary/recipes), and it defaults to `standard` unless an install profile is marked as a distribution. ## Example This info file turns a profile into a distribution for a conference site. The names are made up. ```yaml name: Conference starter type: profile description: 'Starting point for a conference site.' core_version_requirement: ^11.4 distribution: name: Conference Site install: theme: claro finish_url: 'admin/content' ``` With this profile in the codebase, the installer skips the profile choice, shows Conference Site as the name, and redirects the browser to `admin/content` when the installation finishes. [Drupal CMS](/hc/documentation/learn-drupal/drupal-glossary/drupal-cms) uses the same key in its installer profile. ## Common mistakes - **Choosing by the demo.** A distribution is a set of choices made by its maintainers. Read the project page, its release notes and its security advisory coverage before you build a site on one. - **Wondering why the installer skips the profile choice.** A distribution in the codebase wins over the visible profiles. To install another profile, request it explicitly in the install parameters or as the Drush `site:install` argument. - **Using old guides.** The drupal.org page "Creating distributions" is undated and links to Drupal 7 material. Compare it with the core code before copying packaging steps. ## For marketing and content teams A distribution gets a team to a working site fast, because roles, content types and modules are chosen for a use case. The trade-off is that you inherit those choices. Ask your developer which distribution the site started from, so you know whose documentation applies. A site can be built from a distribution and then change, so the editors' screens may differ from the distribution's demo. ## With DXPR DXPR CMS is described on the [DXPR CMS page](/marketing-cms) as a distribution that brings Drupal, the DXPR Builder page builder and DXPR Theme together, curated and maintained by DXPR. ## Sources - [Drupal.org: Distributions](https://www.drupal.org/project/project_distribution) - [Drupal.org: Creating distributions](https://www.drupal.org/developing/distributions) - [Drupal 11.4.10 source: install.core.inc](https://git.drupalcode.org/project/drupal/-/blob/11.4.10/core/includes/install.core.inc) - [Drupal 11.4.10 source: InstallerKernel](https://git.drupalcode.org/project/drupal/-/blob/11.4.10/core/lib/Drupal/Core/Installer/InstallerKernel.php) - [Drush site:install command](https://www.drush.org/13.x/commands/site_install/) - [Drupal.org: Recipes initiative](https://www.drupal.org/about/starshot/initiatives/recipes) - [Drupal CMS Installer 2.2.7 info file](https://git.drupalcode.org/project/drupal_cms_installer/-/blob/2.2.7/drupal_cms_installer.info.yml) - [Drupal.org: Drupal CMS Installer project page](https://www.drupal.org/project/drupal_cms_installer) ## Questions about Distribution ### What is the difference between a distribution and an install profile? An install profile is a folder with a `.info.yml` file of type `profile` that the installer uses to set up a new site. A distribution is an install profile whose info file has a `distribution` key, which makes the installer pick it automatically and show its name instead of Drupal. ### Is Drupal CMS a distribution? Its installer, `drupal_cms_installer`, is an install profile whose info file in release 2.2.7 has a `distribution` key with the name Drupal CMS. The drupal.org project page calls Drupal CMS a platform built on Drupal core. ### How is a distribution different from a recipe? A distribution is chosen once, when the site is installed. The drupal.org recipes initiative page lists its drawbacks: hard to keep updated, impossible to add after a project starts, not easy to remove, and impossible to mix with other functionality. A recipe can be applied at any point in the life of a site and can build on other recipes. ### Where do I find Drupal distributions? On the drupal.org Distributions page. It lists them with filters for maintenance status, development status, stability and security advisory coverage, and sorts by criteria such as most installed or last release. ## Cite this definition "Distribution." DXPR Drupal glossary, https://dxpr.com/hc/documentation/learn-drupal/drupal-glossary/distribution. Last updated October 26, 2026. Copy ## Related terms - [Install profile](/hc/documentation/learn-drupal/drupal-glossary/install-profile) - [Recipes](/hc/documentation/learn-drupal/drupal-glossary/recipes) - [Drupal CMS](/hc/documentation/learn-drupal/drupal-glossary/drupal-cms) - [Module](/hc/documentation/learn-drupal/drupal-glossary/module) - [Composer](/hc/documentation/learn-drupal/drupal-glossary/composer) - [Core](/hc/documentation/learn-drupal/drupal-glossary/core) [All Drupal terms from A to Z](/hc/documentation/learn-drupal/drupal-glossary)