Partners Portal

Create, set up, list and publish a theme from the Salla Partners Portal instead of the CLI.

Read this when you manage your theme in the Salla Partners Portal rather than from the terminal, or need a step the CLI does not cover, such as screenshots and preview stores.

The Portal and the Salla CLI work on the same theme. Use whichever fits the step: the CLI for daily work, the Portal for the store listing.

Create a theme

Open My Themes and choose Create theme. The Portal asks for:

FieldNotes
NameIn English and Arabic, up to 50 characters each
Support emailWhere merchants reach you
CategoriesOne to three theme categories
Theme websiteOptional

The Portal also creates the theme's private GitHub repository. That needs the Salla GitHub App installed on your GitHub account or organisation; the Portal shows the install link when it is missing. Clone the repository, then work on it locally as Create a theme shows.

A new theme starts with a price of 250 SAR and is public. Change both in the listing below.

Set it up

Most setup lives in your code, in twilight.json: the theme's settings, its home blocks and its features. Every change you push to the repository shows in the Portal.

In twilight.jsonShows in the Portal as
settingsTheme settings the merchant fills in
componentsYour own home blocks (Add a home block)
featuresTheme features, such as fonts, color and the built-in home blocks

Change these in twilight.json and push, rather than editing them in the Portal. The repository is the source of truth, and a Portal edit becomes a commit you then have to pull.

Preview it

Create a demo store and choose Preview theme. The demo store's dashboard then runs your theme with its settings and blocks. While you develop, link a store to see your local changes instead.

Fill in the listing

The listing is what merchants see in the theme marketplace.

SectionWhat to add
DescriptionWhat the theme is for, in English and Arabic
ScreenshotsAt least four images (or videos) of the theme
Preview storesUp to four demo stores merchants can browse before buying. One is the default.
PriceA one-time price, with an optional discount and its dates
SupportEmail, mobile, and optional live-chat and documentation links
VisibilityPublic to list it for all stores, Beta while it is still changing, or private to install only by link

Publish

Choose Complete theme publication, check the listing, then Send publication request with a change note in English and Arabic. salla theme publish does the same from the terminal (Publish).

The request goes to Salla's review team. It does not make the theme live at once. Before you send it, the Portal checks that the theme has:

  • at least one category and a price,
  • at least four screenshots,
  • no other request still in review,
  • a verified company ID and services certificate on your partner account.

While a request is in review the theme cannot be edited. To change something, choose Withdraw, fix it, and send a new request. Every update, even to a private theme, goes through a new request and a new review.

Gotchas

  • After a push, read the status of the latest commit in your GitHub repository. The checks Salla runs report problems there.
  • The Portal's Add custom component writes a Twig file into the repository. In a React theme, add your blocks in twilight.json and code instead.
  • A demo store can be the preview store of only one theme.

See also

On this page