# Partners Portal (https://docs.salla.dev/twilight/react/local-development/partners-portal)



Read this when you manage your theme in the [Salla Partners Portal](https://salla.partners) 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](https://docs.salla.dev/twilight/react/local-development/cli-commands) work on the same theme. Use whichever fits the step: the CLI for daily work, the Portal for the store listing.

## Create a theme [#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](https://docs.salla.dev/twilight/react/local-development/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 [#set-it-up]

Most setup lives in your code, in [`twilight.json`](https://docs.salla.dev/twilight/react/guide/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](https://docs.salla.dev/twilight/react/recipes/add-a-home-block))                             |
| `features`         | Theme features, such as `fonts`, `color` and the [built-in home blocks](https://docs.salla.dev/twilight/react/components/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 [#preview-it]

Create a [demo store](https://salla.partners/demo-stores) and choose **Preview theme**. The demo store's dashboard then runs your theme with its settings and blocks.
While you develop, [link a store](https://docs.salla.dev/twilight/react/local-development/link-a-store) to see your local changes instead.

## Fill in the listing [#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 [#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](https://docs.salla.dev/twilight/react/local-development/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 [#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 [#see-also]

* [Publish](https://docs.salla.dev/twilight/react/local-development/publish)
* [Theme review requirements](https://docs.salla.dev/twilight/react/local-development/review-requirements)
* [twilight.json](https://docs.salla.dev/twilight/react/guide/twilight-json)
