Magento 2 - 'Area code not set:' after adding sample data

Magento 2 - 'Area code not set:' after adding sample data

August 28, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Magento 2 - 'Area code not set:' after adding sample data

Troubleshooting Magento 2 ‘Area Code Not Set’ Error After Installing Sample Data

Hello fellow Magento developers! I hope this post finds you well. Today, we’re going to tackle a common issue that arises when trying to install sample data in Magento 2 - the dreaded “Area code not set” error.

The Problem: Area Code Not Set During Sample Data Installation

Let’s start by walking through the steps you’ve already taken:

  1. You ran bin/magento sampledata:deploy to deploy the sample data.
  2. Then, you executed composer update to refresh your dependencies.

After performing these commands, you encountered an error indicating that “Area code not set.” This typically happens when Magento 2 can’t determine which area (frontend or adminhtml) to use during the installation process.

Understanding The Error Message

The error message you’re seeing is quite descriptive:

[Magento\Framework\Exception\SessionException] Area code not set: Area code must be set before starting a session.

[Magento\Framework\Exception\LocalizedException] Area code is not set

In simple terms, Magento 2 requires that the area code (either frontend or adminhtml) is specified before it can initiate a session. Without this information, it doesn’t know which part of the application to work with.

Common Causes Of The ‘Area Code Not Set’ Error

There are several reasons why this error might occur:

  1. Incorrect Command Order: Make sure you’re running the commands in the correct order. Typically, bin/magento sampledata:deploy should be executed before composer update.

  2. Missing Configuration: Check your configuration files (app/etc/env.php and app/etc/config.php) to ensure that the area codes are correctly configured.

  3. Incomplete Installation: Double-check that you’ve completed all the installation steps, including running bin/magento setup:upgrade after updating the database schema via composer.

Resolving The ‘Area Code Not Set’ Error

Now let’s dive into some solutions:

Solution 1: Specify The Area Code Manually

You can try specifying the area code manually when running the sample data deployment command. Here’s an example using the adminhtml area:

bin/magento sampledata:deploy --area-code=adminhtml

Solution 2: Check Your Configuration Files

Ensure that your configuration files contain the correct area codes for both frontend and adminhtml areas.

In app/etc/env.php, you should see something like this under the ‘modules’ array:

'modules' => [
    // ...
    'Magento_AdminNotification' => 100,
    'Magento_AdvancedSearch' => 100,
    // ...
],

And in app/etc/config.php, you’ll find the area codes under the ‘areas’ key:

'areas' =>
array (
  0 => 'frontend',
  1 => 'adminhtml',
),

Solution 3: Run The Commands In The Correct Order

Make sure you’re running the commands in this order:

  1. Deploy the sample data: bin/magento sampledata:deploy
  2. Update the dependencies with composer: composer update
  3. Upgrade the database schema and apply any configuration updates: bin/magento setup:upgrade

Solution 4: Check For Database Corruption

In rare cases, the error might be caused by a corrupted or inconsistent database. You can try running the following commands to check for and fix any issues:

bin/magento indexer:reindex
bin/magento setup:di:compile

Conclusion

The “Area code not set” error is usually a result of an incomplete installation process or incorrect command execution order. By specifying the area codes manually, checking your configuration files, and running the commands in the correct sequence, you should be able to resolve this issue.

Remember, patience and thoroughness are key when troubleshooting Magento 2 errors. Don’t hesitate to consult the official Magento documentation or reach out to the community for further assistance.

Happy coding!

Magento 2 Admin Deployment Orders

Our network