Create an Embedded App

To integrate your application into the Salla Merchant Dashboard, you need to register it in the Salla Partner Portal and configure your embedded pages.

Configure Your App

Step 1: Access the Partners Portal

Select your app from the My Apps section.

Navigate to the Embedded Pages section.

Step 2: Configure an Embedded Page

When adding a new embedded page, you will need to provide the following details:

Route Slug

Define a unique path for your page within the dashboard (e.g., my-app). This will appear in the URL as https://s.salla.sa/embedded/app/{appId}/my-app.

Iframe URL

The full URL where your application is hosted (e.g., https://dashboard.myapp.net/salla/embedded).
Note: Salla will append authentication and layout parameters to this URL (e.g., ?token=XXX&theme=dark), as explained in Authentication.

Default Page

Toggle this option if you want this page to be the primary landing view when a merchant opens your app.

How Salla Loads Your App

The merchant opens the installed app from the Salla dashboard.

The app view renders and displays the "Use App" button.

When the merchant clicks "Use App", Salla loads your app’s configured Embedded Page inside an iframe.

The embedded page establishes a communication bridge using the Embedded SDK.

The embedded app initializes and renders its user interface.

URL Parameters

Salla automatically appends several query parameters to your URL to help with the initial render:

token: A short-lived authentication token.

theme: The merchant's current theme (light or dark).

lang: The merchant's preferred language (ar or en).

Next Steps

Install the SDK

Add the SDK to your project via NPM or CDN to initialize your app.

Setup Authentication

Securely verify session tokens using the Salla Introspection API.

Configure Your App#

Step 1: Access the Partners Portal#

Step 2: Configure an Embedded Page#

How Salla Loads Your App#