React Native SDK - Videowise

The Videowise React Native SDK embeds shoppable video widgets and live shopping in a mobile app.

npm install @videowisehq/videowise-react-native-sdk react-native-webview @react-native-async-storage/async-storage

For Live Shopping Picture-in-Picture, also install react-native-video (>= 6.0.0) and run pod install in your ios/ folder. Setup is on Live Shopping Channel. Web embeds, events, and cookies:

Shoppable videos
Live shopping
Order tracking pixel (web); use trackingPixel in the app
Cookies — getStoredData returns the same uid / lsId values

Live Shopping Channel

Channel embed, modular layout, and Picture-in-Picture.

VideoFeed

Full-screen shoppable video player.

Floating

Overlay widget that opens VideoFeed on tap.

Inline

Stories, carousels, grids, and other in-flow widgets.

Tracking pixel

Attribute orders after checkout.

getStoredData

Read persisted uid and lsId from app storage.

SDK surface

interface VideowiseSDKProps {
  Provider: React.FC<ProviderProps>;
  Inline: React.FC<InlineProps>;
  Floating: React.FC<FloatingProps>;
  VideoFeed: React.FC<VideoFeedProps>;
  LiveShoppingChannel: React.FC<LiveShoppingChannelProps>;
  trackingPixel: (parameters: ParametersType) => Promise<Response | null>;
  getStoredData: () => Promise<StoredData>;
}

Event callbacks use discriminated unions via OnEventType<T>:

Callback	Type parameter	`event.type`	`event.detail`
`onEvent` (widgets)	`'custom-event'`	`'custom-event'`	`EventDetailType` + `name: EventType`
`onEvent` (Live Shopping)	`'live-shopping'`	`'live-shopping'`	`LSTrackingEventData`
`onAddToCart`	`'add-to-cart'`	`'add-to-cart'`	`EventDetailType`
`onCheckout`	`'custom-event'` or `'live-shopping'`	matches component	matches component

Widget onEvent names match Widget custom events. Live shopping onEvent payloads match Live shopping custom events.

Shared props

Available on Inline, Floating, VideoFeed, and LiveShoppingChannel:

Prop	Type	Required	Default	Description
`environment`	`'local' \| 'staging' \| 'production'`	No	`'production'`	Environment target
`loggedInUserData`	`{ email?: string; fullName?: string }`	No	—	Logged-in user info passed to the embed
`onEvent`	`(event: OnEventType<T>) => void`	No	—	Callback for custom events (`T` depends on component)
`onAddToCart`	`(event: OnEventType<'add-to-cart'>) => void`	No	—	Callback when a product is added to cart
`onCheckout`	`(event: OnEventType<T>) => void`	No	—	Callback for checkout events

Inline, Floating, and VideoFeed must be wrapped in <VideowiseSDK.Provider>. LiveShoppingChannel does not.

<VideowiseSDK.Provider>{/* Your components here */}</VideowiseSDK.Provider>

Live Shopping Channel

VideoFeed

Floating

Inline

Tracking pixel

getStoredData

​SDK surface

​Shared props

​Related

SDK surface

Shared props

Related