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:
| Field | Notes |
|---|---|
| Name | In English and Arabic, up to 50 characters each |
| Support email | Where merchants reach you |
| Categories | One to three theme categories |
| Theme website | Optional |
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.json | Shows in the Portal as |
|---|---|
settings | Theme settings the merchant fills in |
components | Your own home blocks (Add a home block) |
features | Theme 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.
| Section | What to add |
|---|---|
| Description | What the theme is for, in English and Arabic |
| Screenshots | At least four images (or videos) of the theme |
| Preview stores | Up to four demo stores merchants can browse before buying. One is the default. |
| Price | A one-time price, with an optional discount and its dates |
| Support | Email, mobile, and optional live-chat and documentation links |
| Visibility | Public 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.jsonand code instead. - A demo store can be the preview store of only one theme.