Salla Docs
Merchant API
  • Merchant API
  • Salla OAuth 2.0
Partner APIs
  • App API
  • Shipment API
Storefront
  • Twilight Engine
  • Twilight SDK
  • Web Components
  • Change Log
Salla CLI
Merchant API
  • Merchant API
  • Salla OAuth 2.0
Partner APIs
  • App API
  • Shipment API
Storefront
  • Twilight Engine
  • Twilight SDK
  • Web Components
  • Change Log
Salla CLI
Salla - Opensource
Salla - Developers Community
  1. Getting Started
  • Getting Started
    • Create a theme
    • Develop a theme
    • Setup a theme
    • Publish a theme
  • Requirements & Review
    • Overview
    • Main Requirements
    • Review Process
      • UI / UX Review
      • Technical Review
      • Metadata Review
      • Pre-Launch Review
  • Files and Folders Structure
    • Directory structure
    • Twilight.json
  • Twig Template Engine
    • Basic syntax
    • Twilight flavoured twig
  • Theme Architecture
    • Layouts
      • Overview
      • Master Layout
      • Global Variables
      • CSS Variables
      • Salla Icons
      • Custom Fonts
      • Hooks
      • Localizations
    • Pages
      • Overview
      • Home Page
      • Product Pages
        • Products listing
        • Single product
      • Customer Pages
        • Profile
        • Orders list
        • Order details
        • Wishlist
        • Notifications
      • Blog Pages
        • Blog listing
        • Single blog
      • Brand Pages
        • Brands listing
        • Single brand
      • Common Pages
        • Cart
        • Loyalty
        • Thank you
        • Single page
        • Landing Page
    • Componenets
      • Overview
      • Home Components
        • Youtube
        • Fixed banner
        • Testimonials
        • Parallax background
        • Photos slider
        • Store features
        • Square photos
        • Fixed products
        • Products slider
        • Featured products - Style 1
        • Featured Products - Style 2
        • Featured Products - Style 3
        • Brands
        • Enhanced Square Banners
        • Main Links
        • Enhanced Slider
        • Slider Products with Headers
        • Latest Products
        • Vertical Menu with Slider
      • Product Components
        • Essentials
        • Options
      • Common Components
        • Header Components
        • Footer Components
        • Comments component
  • Change Log
  1. Getting Started

Setup a theme

Using the Partners Portal, the developer has the ability to manage the theme's setup. This includes managing the theme's basic information, screenshots, settings, features, custom components, and price. Besides that, the developer can preview, delete, publish, or withdraw any theme.

📙 What You'll Learn#

In this article, you will learn how to setup a theme using the Partners Portal. We will also go through the following:
Setting up twilight.json
Setup via the Partners Portal

Setting up twilight.json#

About twilight.json
The Theme's setup can be modified directly from the twilight.json file, which is synced in the Github account connected with the Partners Portal. Explore more on the twilight.json file by reading this guide.
Upon creating / importing a theme, the twilight.json file will be existed in the root directory. Within that file, a developer is able to specify Theme Features, which are the pre-defined theme components, and Theme Components, which are the custom components that are built by the developer. As changes are made to the file, they can be easily synced in the Github account connected to the Partners Portal. Explore more about twilight.json here.

Setup via the Partners Portal#

On the Salla Partners Portal dashboard, the developer needs to click on My Themes in the main navigation menu. This will show the list of available themes. The developer needs to first select a theme and then start with the setup process.
There are two parts for Theme setup which are Basic Settings and Listing Information

Basic Settings#

The Basic Settings will be explained in the coming sections and Listing Information will be further explained in the Theme Publish article.

1 Basic Information#

To start click on edit Theme Name to edit Theme name and category
image

Here you can also update basic information about the Theme, such as Theme icon, name and category.
image

2 Theme Settings#

Personalize the experience via the Theme Settings section by adding custom fields and parameters, which allow for significant control over the Theme.
Settings Page
In there, the drag & drop four fields (String, Numeric, Boolean, and List) bring a unified, straightforward experience for Salla Merchants. A fifth field is Collection, which allows for creating a group of fields that has a mix of the four fields.
Settings Page Details

3 Theme Features#

Mark the Theme features' checkboxes that make up the theme. That said, it is to be customizable from the Merchant side. Explore more about Theme Features here.
Theme Features

4 Extra Features#

If the developed Theme provides extra features, add each of them in a separate line in the field available.
Extra Features

5 Theme Components#

Add a custom component by clicking on "Add Custom Component". This kind of component is developed by the developer.
Hi
Provide the details of the custom component in terms of the title, icon, and file path of the component.
Add Component
That will result in having the custom component added.
Result
Edit and update the previously inputted basic information of the custom component, such as the title, icon, and file path. The pop dialog will showcase the fields to be updated.
Custom Component Basic Info
By going to the Settings page of the custom component, several setting fields can be added for that specific component.
Settings Page
The custom components setting page will appear as follows, where it is easy to add the fields that customize the component in a drag & drop way, each with its own properties and functionalities that will be reflected on the Merchant side.
Settings Page Details

6 Theme Preview#

The Partners Portal provides this feature to preview the themes in a demo store for quality assurance, before submitting a publication request. Explore what is suitable and enjoy the progress so far while developing the theme.
Test & Preview Options
Create a new demo store, unless one is already created, and click on the "Preview Theme".
Preview Theme
On the demo dashboard, the theme will then be in the preview mode to which all the changes made to the theme, in terms of components, pre-defined and custom, and settings, will be reflected.
A thing to know!
🖥️ Salla CLI, which is a command-line tool developed by Salla team, can be used to preview a theme.

7 Theme Details#

Write details about the Theme to grab the attention of the Merchants, which will be apparent in the Store Themes Marketplace.

8 Theme Preview in Live Store#

You can preview the theme on live stores by adding the store link then clicking on "sending the installation request" button.
Theme Details

9 Theme Installation#

The developer can decide the Theme installation methods as follows:
a. By ticking this option, the devloper indicates that the theme is public an available for all stores.
b. By ticking this option,the theme is beta and under development.
c. By ticking this option, the theme is private and can only be installed by.installation link
d. In this box, the developer can copy the theme installation link for store to install it via installation link
Live Store Request
By getting here you have successfully completed theme setup.
Modified at 2025-03-04 12:54:02
Previous
Develop a theme
Next
Publish a theme