All the following examples are for a Store Page but are applicable to any embeddable component.

​
Embedding using a prebuilt React component

​
Basic usage

We also provide the @sidedish/react package that you can use to easily embed your store. To use it, simply run: 
npm install @sidedish/react
The npm package is super lightweight. To use it, simply provide store url and optional sessionId. 
import { StorePage } from '@sidedish/react';

const StoreEmbed = () => {
const STORE_PAGE_URL = 'YOUR_PAGE_URL'; // Consider saving this in your environment variables
return <StorePage url={STORE_PAGE_URL} />;
};

// And the component where you want to embed:

<StoreEmbed />;

​
With an authenticated user

If you are creating a safe session to the store then use this code: 
import { StorePage } from "@sidedish/react";

// You get the sessionId from somewhere else
const StoreEmbed = (sessionId:string) => {
const STORE_PAGE_URL = 'YOUR_PAGE_URL'; // Consider saving this in your environment variables
return <StorePage url={STORE_PAGE_URL} sessionId={sessionId} />
};

// And the component where you want to embed:
<StoreEmbed sessionId={sessionId} />;

​
Internal users

To avoid tracking events and analytics made by your internal employees, you can pass true in the internal property of the Store component. Another way to do this is to use the internal property of passed user object in the unsafeParams or the safe session. 
    import { StorePage } from "@sidedish/react";
	
	const STORE_PAGE_URL = 'YOUR_PAGE_URL'; // Consider saving this in your environment variables

    const StoreEmbed = () => {
		const isInternalUser = useIsInternalUser(); // your own logic
    	return <StorePage url={STORE_PAGE_URL} internal={isInternalUser} />
    };

    // And the component where you want to embed:
    <StoreEmbed />;

​
Embedding as an iframe

​
Basic usage

If you embed a store without the need for callbacks, then the easiest way to embed that store in your website would be by using an iframe: 
<iframe
    src="https://YOUR_PAGE_URL"
    style="width: 100%; height: 100%; border: none;"
    allow="clipboard-write"
    loading="lazy"
>
</iframe>
Yes, it’s really that simple.

​
Specific page

You can embed a specific page in the iframe method by just including /p/{X} in the url, where X can be either page id or page slug. 
<iframe
    src="https://YOUR_PAGE_URL/p/PAGE_ID"
    style="width: 100%; height: 100%; border: none;"
    allow="clipboard-write"
    loading="lazy"
>
</iframe>

​
With a safe session

<iframe
    src="https://{YOUR_PAGE_URL}?$sessionId={SESSION_ID}"
    style="width: 100%; height: 100%; border: none;"
    allow="clipboard-write"
    loading="lazy"
>
</iframe>

​
Internal users

To avoid tracking events and analytics made by your internal employees, you can pass a $internal=true parameter in the search params of the url. Another way to do this is to use the internal property of passed user object in the unsafeParams or the safe session. 
<iframe
    src="https://{YOUR_PAGE_URL}?$internal=true"
    style="width: 100%; height: 100%; border: none;"
    allow="clipboard-write"
    loading="lazy"
></iframe>

​
Passing parameters unsafely

We support passing any of the acceptable parameters in an unsafe way if you use them just for display purposes and don’t use them for actual effects anyway. Passing parameters is relatively straight forward, and depends on your implementation:
  • In the React component you could include the unsafe params as JSX prop- unsafeParams.
  • In the iframe method you would simply include the params in the url in a querystring manner but preceding with $ to guarantee uniqueness- URL?$accountId=SOME_ID&$userId=ANOTHER_ID. This is only required in the iframe method and not in the react method. Please use JSON.stringify() the values. 
<StorePage url={STORE_PAGE_URL} unsafeParams={{ accountId = 'SOME_ID' }} />

​
Callbacks

We support plenty of actions inside a store, including custom callbacks.
1

Set origin validation in admin

Go to app.sidedish.com/ and navigate to the desired store settings page. Set up a origin validation hostname and set that up to your domain.
2

Set a callback for a button somewhere in your store

In the layout of the store, define a “Javascript Callback” and set its identifier to a unique string of your liking, that would be the ACTION_IDENTIFIER, so you could recognize specific events of that kind. Since a store can have multiple callbacks, the id is used to recognize a specific action. You could however use the same id on multiple places in the store to call for the same callback.
3

Create your function

If you used the React method that is even simpler as you could just pass a function callback as the property onCallback:
import { useRef } from 'react';
import { CallbackEvent } from '@sidedish/react';

const StoreEmbed = () => {
	const storeRef = useRef(null);
	const onCallback = (e: CallbackEvent) => {
		if (e.actionIdentifier === 'ACTION_IDENTIFIER'){
			// Do whatever you want.
			doSomething(e.payload);

			// 1) If the callback has caused a change in the unsafe params, you can just update the passed `unsafeParams` and the component
			// will take care of posting an update event for you. This is the same as doing:
			// storeRef.current.updateUnsafeParams({}) but easier to just update `unsafeParams`

			// 2) If there was a change in data that is included in the safe session, you can ask the store to reload the session:
			if (storeRef.current){
				storeRef.current.reloadSession();
			}
		}
	}

	const STORE_PAGE_URL = 'YOUR_PAGE_URL'; // Consider saving this in your environment variables
	return <StorePage url={STORE_PAGE_URL} onCallback={onCallback} ref={storeRef} />;
};
The props of the event are:
​
actionIdentifier
string
The action id that you’ve set in the admin dashboard
​
payload
object
4

Test

Make sure everything works as intended.

​
Path changes

Preserving path changes provides the user with a bookmarkable page in the store, and is highly recommended.
1

Pass current page to store

Store url should reflect the page from the browser. The implementation depends on your code.
2

Register changes in store and reflect in browser history

Listen to onPathChange callback on the Store.
import { StorePage } from '@sidedish/react';

const StoreEmbed = () => {
const STORE_PAGE_URL = 'YOUR_PAGE_URL';
const STORE_PAGE_PATH = '/my-marketplace';

    const onPathChange = (path:string) => {
    	window.history.pushState({}, '', `${STORE_PAGE_PATH}${path}`);
    }

    const pathname = window.location.pathname.replace(STORE_PAGE_PATH, '');
    const url = `${STORE_PAGE_URL}${pathname}`;
    return <StorePage url={url} onPathChange={onPathChange} />;

};