Kosmic - Magento 2 Theme | Documentation

Kosmic - Getting Started


Thank you for downloading Magento theme. This documentation consists of several parts and covers the entire process of installing and setting up Magento 2 theme starting from scratch.

Kosmic Theme files structure

The theme package you have downloaded consists of several folders. Let's see what each folder contains:

  • documentation
    contains documentation files.
    • documentation.html
      a main documentation file you are reading at the moment.
  • sources
    contains the theme source files.
    • screenshots.zip
      contains the theme screenshots for reference
    • demo-pages.zip
      contains all the demo pages .txt files
    • demo-blocks.zip
      contains all the demo static blocks .txt files
  • theme-files
    contains kosmic theme files data
    • kosmic-theme.zip
      contains kosmic theme files
    • kosmic-theme-magento-2.1.x-patch.zip
      contains Kosmic theme patch files for magento 2.1.x.
    • kosmic-theme-magento-2.2.x-patch.zip
      contains Kosmic theme patch files for magento 2.2.x.
    • kosmic-theme-magento-2.3.x-patch.zip
      contains Kosmic theme patch files for magento 2.3.x.
  • kosmic-demo.url
    redirect to kosmic theme demo.


Before you install Magento, you must check all of the following:


  • You must run Apache version 2.2 or 2.4.
  • In addition, the apache mod_rewrite module must be enabled. mod_rewrite enables the server to perform URL rewriting.


  • 5.6.x
  • 5.5.x, where x is 22 or greater
  • 7.0.2 up to 7.1.0, except for 7.0.5

Required PHP extensions:

  • mbstring
  • mcrypt
  • mhash
  • SimpleXML
  • curl
  • xsl
  • gd, ImageMagick 6.3.7 (or later) or both
  • soap
  • intl
  • bc-math (Enterprice Edition Only)
  • openssl


  • You must run MySQL version 5.6 or later

File Permission

The web server user must have write access to the following files and directories:

  • var
  • app/etc
  • pub

We recommend setting the permissions as follows:

  • All directories have 770 permissions.
  • 770 permissions give full control (that is, read/write/execute) to the owner and to the group and no permissions to anyone else.
  • All files have 660 permissions.
  • 660 permissions mean the owner and the group can read and write but other users have no permissions.

Complete installation

The complete installation method can be used if you want to set up a Magento store using a sample content. We assume that you have completed all the preparation steps.

The installation process consists of 3 stages:

1. Creating a database.

2. Uploading all the required files to the server.

3. Installing a Magento Commerce engine together with the template you have purchased.

Let's get started!

Creating a database

First, you need to prepare a new database for your Magento store. You can create the new database using the database management tool from your hosting control panel (usually PhpMyAdmin).

The following data will be received while creating a database: database name, database username, password and you server name. You need to save this data as you will need it for further Magento installation.

With the phpMyAdmin tool you will be able to create a new database in 3 simple steps(check the slides below):

1. Open the "Database" tab, you will see the list of databases.

create database - image1

2. Input your database name. Click "Create" button.

create database - image2

3. Your database has appeared in the list. In order to enter the database, click on its name in the list.

create database - image3

If you have any issues with creating a database, please contact your hosting provider for help and assistance.

Magento Installation

When you are done with uploading files, you can start Magento engine installation process. Open your browser and in the address bar type your 'domain name/path to your Magento directory'. You should see the welcome screen. Please follow the instructions below to install Magento.

Step 1: Installation Assistant

Please read the license agreement and click the "Agree and Setup Magento" checkbox if you agree with the terms.

how to install - image1

Server Readiness Check

Click the "Start Readiness Check" button to check your server settings compatibility with the Magento 2 engine requirements.

how to install - image2

Step 2: Database connection

Here you need to input the database details and some initial settings. Add a Database – input your host name, database name, database user and password. Contact your hosting provider, if you don't have the necessary details.

Make sure you have a database created for the Magento installation. And also make sure it is clear, without any tables.

how to install - image4

Step 3: Web Configuration

Here you can change Magento admin panel URL and the main store address. Other settings you can leave unchanged.

Make a point of the admin panel path. Note it or insert your specific admin panel URL to remember the admin panel access.

how to install - image5

When the checking procedure is complete, click 'Next'. button.

Step 4: Localization

Select the required time zone, default currency and store language. In the Advanced Modules Configurations section you can also select default modules that should/shouldn't be installed. We recommend that you do not perform changes in this section.

how to install - image6

When the checking procedure is complete, click 'Next'. button.

Step 5: Create Admin Account

Here you need to input personal details for the store owner and administrator.

how to install - image7

Step 6: Install

The store configuration is done. Press the Install Now button to start the store installation process.

how to install - image8

Step 7: Success

This is the final installation step. Copy the generated encryption key and keep it safe.

how to install - image9

Kosmic theme installation

This theme is not compatible with Magento 1.x engine. It will work with the Magento 2.x engine only.

First of all, please make sure your Magento installation version meets the template requirements. If you are using an outdated Magento engine version, you need to upgrade it. Don't forget to make a backup of your store files and database. The detailed Magento update guide you will find on the site Magento Wiki.

If your Magento engine meets the template requirements, you can start the template installation.

1. Open the theme package(kosmic-multipurpose-responsive-magento-theme.zip) and go to the Theme Files folder.

2. Extract "kosmic-theme.zip" file and Upload the app folder to the root Magento installation directory on your server. This folder includes the template files, that will not effect your existing files. If you are using Magento 2.1.x version then add the patch files.

3. Once done with uploading "app" folder, you need to execute below command at magento root directory using command line

For Linux: bin/magento setup:upgrade

For Windows: php bin/magento setup:upgrade

For more details click here

Prepare Update

1. We recommend you to duplicate your live store on a development store and try update Kosmic version on it in advance.

2. Backup magento files and the store database.


Its very important to backup all of themes and extensions in Magento before installation, especially when you are working on a live server. We strongly recommend you to do not omit this step.

3. Enable all caches in your magento.


It's very important to enable the caches, Because, sometimes, some of the extensions of the theme were installed incorrectly. So you should enable the caches during upload the theme files, then you should disable or clear the caches, when complete to upload the theme files.

4. Upload the theme files.

5. Disable compilation mode in System > Tools > Compilation.

6. Disable all cache related section that you have in your magento.


To apply the your changes working, you should disable or clear all of cache related sections, such as magento default cache, magento cache extension or CDN etc. The best choice is to disable all of them and enable it after you finish your work.

7. Log out from magento admin panel and log in again. Its essential to Logout/Login again to refresh your control panel.

Template configuration

We are going to review template configuration options based on the example. We will configure it the same way as our Live Demo template, without affecting products data.

Activate the new theme

1. (For 2.0.x) Open Magento admin panel and navigate to Stores > Configuration menu.

Theme set - image1

(For 2.1.x) Open Magento admin panel and navigate to Content > Design > Configuration menu.

Theme set - image1-1

2. (For 2.0.x) In the General menu select Design tab. Click Design Theme tab and in the Design Theme drop-down list select the required theme, then click Save Config button.

Theme set - image2

(For 2.1.x) Go to Edit.

Theme set - image2

(For 2.1.x) Select the template from dropdown. And click on 'Save Configuration'

Theme set - image2

Reindex data

1. In the fist column open the drop-down list and choose the "Select All" option.

Theme set - image3

2. In the fist column open the drop-down list and choose the "Select All" option.

Theme set - image4

3. In the top "Actions" selector choose "Update on save" option. It will allow automatically reindex the specified data after saving any settings in the admin panel.

Theme set - image5

Click "Submit" button.

Please be patient, this may take a while.

Reindex data using command line

In order to reindex data using command line, please execute below command at magento root directory

bin/magento indexer:reindex

For more details click here

Disable cache

In order to make the changes appear on your website with no delay, you need to disable cache. It prevents additional cache clearing actions after every change you make. You can enable it when you are done with store editing.

1. Open Magento admin panel and navigate to System > Cache Management menu.

Theme set - image6

2. In the fist column open the drop-down list and choose the "Select All" option.

Theme set - image7

3. In the top "Refresh" field select "Disable" option.

Theme set - image8

4. Click "Submit" button.

Logo configuration

For 2.0.x

Please follow these steps when setting up logo image included into the theme package (you can view it on the Live Demo page).

1. Open the Magento admin panel and select Stores > Configuration in the side menu.

Theme set - image9

2. Select the "General" tab.

Theme set - image10

3. In the "General" section, select the Design tab. Choose Header, and upload your logo.

4. Click "Save Config" button.

For 2.1.x

Open Magento admin panel and navigate to Content > Design > Configuration menu.

Theme set - image9-1

2. Expand the "header" tab.

Theme set - image10-1

3. In the "Header" section, click on 'Upload' button to upload your logo.

4. Click "Save Configuration" button.

Pages configuration

In order to make your template look exactly like our Live Demo, you need to set up store pages in a specific way. We provide all the files with the pages source code (kosmic-multipurpose-responsive-magento-theme.zip/sources/demo-pages). You need to add them into Magento admin panel as per the below instructions:

1. From the top menu select Content > Pages. Here you can find all the store pages. Home page, About Us and Customer Service should already be available, so you don't need to add them. You only need to update the pages HTML and XML content. Open any of them in order to get the access to the content.

page settings - image2

2. Open the page and select the Content tab. It contains the HTML code of the page. We have source code for look home page exactly like our Live Demo.

For this, please go to kosmic-multipurpose-responsive-magento-theme.zip/sources/demo-pages in given theme zip file. There are 2 files : home and home2. Open any file, copy the code from that file and paste it to the content area.

page settings - image3

3. To add Widget click on Insert Widget.. button. It will open popup , from there select widget that you want to display on home page with widget options and click on Insert Widget button

add widget

4. When you are done with the HTML code, switch to "Design" tab. It contains the page XML code. XML code allows you to add Magento static blocks and widgets to the page. The XML code should be copied the same way as the HTML from the source file. Copy the XML code to the "Layout Update XML" area.

page settings - image4

5. Don't forget to select the valid "Layout" option.

6. In case you need to add a new page, click the "Add New Page" button in the top right corner.

Static blocks configuration

When you are done configuring the pages, you need to configure the static blocks. The procedure is similar: you need to copy the code from the source files (kosmic-multipurpose-responsive-magento-theme.zip/sources/demo-blocks) and paste it to the corresponding fields in the Magento admin panel.

1. In the top menu navigate to Content > Blocks.

2. In the top right corner click the "Add New block" button to add a new static block.

static block - image1

Specify the block name and identifier. You can get the block details from kosmic-multipurpose-responsive-magento-theme.zip/sources/demo-blocks.zip

Open the block source file and copy the HTML code into the content area.

static block - image2

When you are done configuring store pages and blocks, your store is ready to go.

Theme Settings

Open Magento admin panel and navigate to Theme Cpanel.

theme cpanel

Click on Theme Cpanel > Configuration. Set Predefined theme color or set custom theme color for different stores.

theme setting

Layout Configuration

Set Theme layout: Full-width Layout, Box Layout and Maximum Width: 1170, 1280 (Default)

theme layout

Static Content Configuration

Add static block identifier to display content on home page, register page, contact page and product detail page.

Static Content Configuration

Header Configuration

Click on Header tab. From that you can set Top Header Notification, custom information static block, enable/disable Sharing addon with Pub ID of Addthis (you can get pub id from addthis.com) and set header type from 2 different header layout.

header configuration

Product Page Configuration

On product list page admin can easily enable or disable New & Sale label, Enable/Disable product block effect, Keep product image aspect ratio, Set image width, Alternate image on hover etc from product configuration option.
Also in product view page show sharing addons from that customer's can share product on social media. Show/hide Related, Upsell & Crosssell products from product view page.

product configuration

Contact Page Configuration

In Contact page, Admin can show google map for their store by using Google map embeded code. Also set their store name, store address, contact info, store email etc from admin on contact page.

contact configuration

Loader Settings

Show loader on home page or all pages with uploaded loader image

loader settings

Add Custom Css

Add custom css that will apply on all pages on frontside

add custom css

Import cms blocks & pages

Import Static Blocks button import all the static blocks that comes with kosmic theme. If you want to overwrite existing blocks than select Overwrite Existing Blocks to Yes and Save Config. Then after Click on Import Static Blocks button. Do same for import cms pages.

import blocks and pages

Design Settings

Open Magento admin panel and navigate to Theme Cpanel.

theme cpanel design

Set Header Top, Search box, Navigation Menu, Minicart block colors

header design

Set Footer Top Newsletter block, Social block, Footer Middle(Links) block, Bottom(Copyright) block etc

footer design

Add You custom CSS.

Custom CSS

How to change newsletter popup settings?

newsletter popup

Go to Theme Cpanel > Newsletter > Configuration

From that you can change newsletter settings like,

General Settings: Show/hide Newsletter Popup

Content Display Settings: Show/hide/change main title, change main title font color, text size etc, set custom message, show newsletter popup checkbox, show background image etc

Popup Box Settings: Popup box height & width, open & close effect, set delay time for popup appear, set cookie expiration time etc

Social Options: Show social icons with url like facebook, google plus, twitter, youtube, flicker, vimeo, pinterest, instagram, foursquare, tumblr, rss, email etc

How to edit homepage slider?

To edit homepage slider content, please go to Admin Theme Cpanel > Banner Slider > Manage Bannerslider and you can add/edit bannerslider as per your requirement.

You can also change bannerslider configuration from Theme Cpanel > Banner Slider > Configuration

How to add static blocks on homepage?

To show static blocks in homepage, add below code in cms homepage (Content > Pages > Home Page > Design Tab)

{{widget type="Magento\Cms\Block\Widget\Block" template="widget/static_block/default.phtml" block_id="[id]"}}

home static block 1

{{widget type="Magento\Cms\Block\Widget\Block" template="widget/static_block/default.phtml" block_id="[id]"}}

home static block 2

{{widget type="Magento\Cms\Block\Widget\Block" template="widget/static_block/default.phtml" block_id="[id]"}}

home static block 3

{{widget type="Magento\Cms\Block\Widget\Block" template="widget/static_block/default.phtml" block_id="[id]"}}

home static block 4

{{widget type="Magento\Cms\Block\Widget\Block" template="widget/static_block/default.phtml" block_id="[id]"}}

home static block 6

How to show product blocks on homepage?

Featured Products - It shows the products which "Is Featured" attribute is "yes".

{{block class='Solwin\FeaturedPro\Block\Home\FeaturedList' name='featured_data' template='list.phtml'}}

home featured products

New Products - It shows the products which all products sort by latest input automatically.

{{widget type="Magento\Catalog\Block\Product\Widget\NewWidget" display_type="all_products" products_count="10" template="product/widget/new/content/new_grid.phtml"}}

home new products

How to show latest post on homepage?

Use this code to show latest post on homepage

{{block class='Solwin\Ourblog\Block\Bloghome' name='ourblog_data2' template='bloghome.phtml'}}

latest post

How to show testimonials on homepage?

Use this code to show clients speak on homepage

{{block class='Solwin\Testimonial\Block\Home\Testimonial' name='testimonial_data' template='testimonial_home.phtml'}}

client testimonials

How to show shop by brand slider on homepage?

Use this code to show shop by brand slider on homepage

{{block class='Solwin\Ourbrand\Block\Home\Ourbrand' name='ourbrand_data' template='Solwin_Ourbrand::ourbrand_home.phtml'}}

shop by brand

How to show best deals product widget on homepage?

Use this code to show best deals widget on homepage

{{widget type="Solwin\ProductWidget\Block\Widget\BestList" bestdeals_title="Best Deals" bestdeals_items="5"}}

Best deals widget


Kosmic is a fully responsive, creative, clean, beautiful and multipurpose Magento 2 theme with latest web design trends. It is multi-purpose professional theme for any ecommerce business like electronics, fashion, jewelery, furniture etc… with readymade layouts and color options.

The following resources will help you to become a true Magento professional:

Useful resources

Help and Support

Frequently Asked Questions

What can cause the problem:

  • - Magento cache (or external cache) was not flushed after installation of the theme.
  • - Compilation mode was not disabled before installation.
  • - Some of the theme files were not uploaded.
  • - You edited theme files and accidentally removed or changed something in the files.
  • - You have customized the theme by creating custom sub-theme and your modifications change/break the default behavior of the theme.
  • - Sometimes you have installed other theme and some elements are currently affecting the current theme.
Yes. You can easily change your theme color from Theme Cpanel > Configuration > Theme settings > General.
You can select other home page from Store > Configuration > General > Web, select your home page from CMS Home Page.
This may be file permissions issue, or your Magento does not have access to images because of incorrect file permissions on your server. First, make sure that images were uploaded and if correct paths to those files are specified. You need to set correct file permissions for all images and folders (in most cases images are stored in pub/media directory).
Flush Magento cache in System > Cache Management, clear web browser cache/cookies for your store domain and refresh the page in your web browser.
Generally all extensions can work with all themes but sometimes they have to be integrated manually. That is because sometimes the extension and the theme override the same Magento template file so there can be a conflict.
You can completely disabled extensions from Store > Configuration > Advanced > Advanced

Massive Updates are Coming!

It's not the end. Here are some upcoming features of kosmic:

  • - Improved Layered Navigation
  • - Megamenu
  • - Best Deals Extension
  • - More Config Option
  • - More Theme layout

Thanks for using Kosmic Theme!

We would like to thank you for using our Kosmic Magento 2 Theme! We are very pleased you have chosen Kosmic for your next Magento store. If you have any difficulties with Kosmic theme or need any additional service, do not hesitate to contact us. We provide 24/7 Support!

Regarding customization service based on our themes or other magento related, please contact us to support@solwininfotech.com. We have an amazing team to provide customization service who have done bunch of customization projects so far, will provide you reasonable quote before start.


We are very happy to assist you!