ms_websites.md

layout	group	subgroup	title	menu_title	menu_order	menu_node	version	github_link
default	config-guide	11_sites	Set up multiple websites, stores, and store views in the Admin	Set up multiple websites, stores, and store views in the Admin	2		2.0	config-guide/multi-site/ms_websites.md

Set up multiple websites, stores, and store views in the Admin

This task requires you to create a root {% glossarytooltip 50e49338-1e6c-4473-8527-9e401d67ea2b %}category{% endglossarytooltip %} (and additional categories if desired) for each store.

The tasks discussed in this topic provide one way to set up multiple stores. For additional information, see the following resources in the Magento User Guide:

• Categories{:target="_blank"}
• Adding Websites{:target="_blank"}
• Store URLs{:target="_blank"}
• Content{:target="_blank"}

For example purposes only, we use a French {% glossarytooltip a3c8f20f-b067-414e-9781-06378c193155 %}website{% endglossarytooltip %} with website code `french` in this topic. For step-by-step tutorials, see:

• [Tutorial—Set up multiple websites with Apache]({{ page.baseurl }}config-guide/multi-site/ms_apache.html)
• [Tutorial—Set up multiple websites with nginx]({{ page.baseurl }}config-guide/multi-site/ms_nginx.html)

Step 1: Create root categories

Creating a root category is optional, but we show how to do it in this tutorial in the {% glossarytooltip c57aef7c-97b4-4b2b-a999-8001accef1fe %}event{% endglossarytooltip %} you want each website to have a unique root category. You can create additional categories if you choose.

{% collapsible To create a root category: %}

1. Log in to the Magento Admin as a user authorized to create categories.

2. Click Products > Categories.

3. Click Add Root Category.

4. In the Category Name field, enter a unique name to identify this category.

5. Make sure Enable Category is set to Yes.

   For information about the other options on this page, see Root Categories{:target="_blank"}.

   The following figure shows an example.

   {:width="500px"}

6. Click Save.

7. Repeat these tasks as many times as necessary to create root categories for your stores.

{% endcollapsible %}

Step 2: Create websites

{% collapsible To create a website: %}

1. Log in to the Magento Admin as a user authorized to create websites, stores, and store views.

2. Click Stores > Settings > All Stores.

3. On the Stores page, click Create Website.

   • Name field: Enter a name to identify the website.
   • Code field: Enter a unique code; for example, if you have a French store, you can enter french
   • Sort Order field: Enter an optional numerical sort order.

   The following figure shows an example.

   {:width="500px"}

4. Click Save Web Site.

5. Repeat these tasks as many times as necessary to create your websites.

{% endcollapsible %}

Step 3: Create stores

{% collapsible To create a store: %}

1. In the Magento Admin, click Stores > Settings > All Stores.

2. On the Stores page, click Create Store.

   • Web Site list: Click the name of the website with which to associate this store.
   • Name field: Enter a name to identify the store.
   • Code field: Enter a unique code to identify the store.
   • Root Category list: Click the name of the root category for this store.

   The following figure shows an example.

   {:width="500px"}

3. Click Save Store.

4. Repeat these tasks as many times as necessary to create your stores.

{% endcollapsible %}

Step 4: Create store views

{% collapsible To create a store view: %}

1. In the Magento Admin, click Stores > Settings > All Stores.

2. On the Stores page, click Create Store View.

   • Store list: Click the name of the store with which to associate this store view.
   • Name field: Enter a name to identify this store view.
   • Code field: Enter a unique name to identify this store view.
   • Status list: Click Enabled. The following figure shows an example.

   {:width="500px"}

3. Click Save Store View.

4. Repeat these tasks as many times as necessary to create your store views.

{% endcollapsible %}

Step 5: Change a website's base URL

To access a website using a unique {% glossarytooltip a05c59d3-77b9-47d0-92a1-2cbffe3f8622 %}URL{% endglossarytooltip %} like http://french.magento.mg, you must change the base URL for each site in the {% glossarytooltip 18b930cf-09cc-47c9-a5e5-905f86c43f81 %}Magento Admin{% endglossarytooltip %}.

{% collapsible To change the website's base URL: %}

1. In the Admin, click Stores > Settings > Configuration > General > Web.

2. From the Store View list at the top of the page, click the name of one of your websites as the following figure shows.

   {:width="250px"}

3. In the right pane, expand Base URLs.

4. In the Base URL section, clear the Use Default check box.

5. Enter http://french.magento.mg as the following example shows.

   {:width="650px"}

   If you're setting up a base URL for deployment Magento Enterprise Cloud Edition, you must replace the first period with three dashes. For example, if your base URL is french.branch-sbg7pPa-f3dueAiM03tpy.us.magentosite.cloud, enter http://french---branch-sbg7pPa-f3dueAiM03tpy.us.magentosite.cloud.

   If you're setting up a base URL for local testing, use a period.

6. Click Save Config.

7. Repeat these tasks for other websites.

{% endcollapsible %}

Step 6: Add the store code to the base URL {#multi-storecode-baseurl}

Magento gives you the option to add the store code to the site's base URL, which simplifies the process of setting up multiple stores. Using this option, you don't have to create directories on the Magento file system to store index.php and .htaccess.

This prevents index.php and .htaccess from getting out of sync with the Magento codebase in future upgrades.

For more information, see the Magento User Guide{:target="_blank"}.

{% collapsible To add the store code to the website's base URL: %}

1. In the Admin, click Stores > Settings > Configuration > General > Web.

2. From the Store View list at the top of the page, click Default Config as the following figure shows.

   {:width="250px"}

3. In the right pane, expand Url Options.

4. Clear the Use system value check box next to Add Store Code to Urls.

5. From the Add Store Code to Urls list, click Yes as the following figure shows.

   {:width="550px"}

6. Click Save Config.

7. If prompted, flush the Magento cache. (System > Cache Management).

{% endcollapsible %}

Step 7: Change the default store view's base URL

You must perform this step last because after it's done, you'll lose access to the Magento Admin; your access returns after you set up virtual hosts as discussed in the web-server-specific topics.

{% collapsible To change the default store view's base URL: %}

1. In the Admin, click Stores > Settings > Configuration > General > Web.

2. From the Store View list at the top of the page, click Default Config as the following figure shows.

   {:width="250px"}

3. In the right pane, expand Base URLs.

4. Enter http://mysite.mg as the following example shows.

   {:width="650px"}

   If you're setting up a base URL for Magento Enterprise Cloud Edition, you must replace the first period with three dashes. For example, if your base URL is french.branch-sbg7pPa-f3dueAiM03tpy.us.magentosite.cloud, enter http://french---branch-sbg7pPa-f3dueAiM03tpy.us.magentosite.cloud.

5. Click Save Config.

{% endcollapsible %}

Next step

• Magento Enterprise Cloud Edition: [Set up multiple Cloud websites or stores]({{ page.baseurl }}cloud/project/project-multi-sites.html)
• [Tutorial—Set up multiple websites or stores with nginx]({{ page.baseurl }}config-guide/multi-site/ms_nginx.html)
• [Tutorial—Set up multiple websites with Apache]({{ page.baseurl }}config-guide/multi-site/ms_apache.html)

Related information

Add content to your websites{:target="_blank"}