Magento sample data includes a sample store, complete with more than 250 products (about 200 of them are configurable products), categories, promotional price rules, CMS pages, banners, and so on. Sample data uses the Luma theme on the storefront.
Installing sample data is optional.
Technically, sample data is a set of regular Magento modules, which can be deployed and installed together with the Magento instance, or later in the scope of upgrade.
You can deploy sample data from one of the following sources:
- From the Magento composer repository, optionally using Magento CLI
- From the Magento GitHub repository
If your Magento code base was cloned from the master
branch, you can use either source of the sample data. If it was cloned from the develop
branch, use the GitHub repository and choose to get sample data modules from the develop
branch.
To deploy sample data from the Magento composer repository using Magento CLI:
- If your Magento instance is already installed, skip this step. Otherwise, in the Magento root directory, run:
# composer install
. - In the Magento root directory, run:
# bin/magento sampledata:deploy
. This command collects the dependencies from thesuggest
sections of thecomposer.json
files of modules, which suggest to install sample data (likeMagento_Catalog
,Magento_Sales
, and so on).
To deploy sample data from the Magento composer repository without Magento CLI:
- Specify sample data packages in the
require
section of the rootcomposer.json
file, for example:
{
"require": {
...
"magento/module-catalog-sample-data": "{version}",
"magento/module-configurable-sample-data": "{version}",
"magento/module-cms-sample-data": "{version}",
"magento/module-sales-sample-data": "{version}"
....
}
}
Where <version>
is the version of the packages; it should correspond to the version of the Magento instance.
Each package corresponds to a sample data module. The complete list of available modules can be viewed in the [sample data GitHub repository] (https://github.com/magento/magento2-sample-data/tree/develop/app/code/Magento)
- To update the dependencies, in the Magento root directory, run:
# composer update
To deploy sample data from the GitHub repository:
- Clone sample data from
https://github.com/magento/magento2-sample-data
. If your Magento instance was cloned from themaster
branch, choose themaster
branch when cloning sample data; choose thedevelop
branch if Magento was cloned fromdevelop
. - Link the sample data and your Magento instance by running:
# php -f <sample-data_clone_dir>/dev/tools/build-sample-data.php -- --ce-source="<path_to_your_magento_instance>"
Once the sample data is deployed, it will be installed automatically when you install or upgrade your Magento instance by using the command line.
To remove the sample data modules from the code base, run one of the following commands from the Magento root directory:
- If sample data was deployed from the composer repository, run:
# bin/magento sampledata:remove
- If sample data was deployed from the GitHub repository and linked to your Magento instance, run:
# php -f <sample-data_clone_dir>/dev/tools/build-sample-data.php โ --command=unlink --ce-source="<path_to_your_magento_instance>"
To delete all the products and other entities provided by the sample data modules, delete the database and reinstall Magento with a clean database.
If you have deleted certain entities provided by sample data and want to restore them, take the following steps:
- From the Magento root directory, run the following command:
# bin/magento sampledata:reset
- Upgrade Magento as usual.
The deleted sample data entities will be restored. Those entities, which were changed, will preserve these changes and will not be restored to the default view.
You can find the more detailed description of sample data manipulation procedures at http://devdocs.magento.com/guides/v2.4/install-gde/install/cli/install-cli-sample-data.html