Embedding Modes

​

1. Shopify storefront widgets

​

2. Universal website embed widget

• Admin customisation panel: configure the widget layout, theme, and auth mode without writing code.
• Works anywhere: Shopify (non-theme-extension surfaces), custom sites, CMS-hosted pages.
• CSP: PR #2333 opened the Nudj user app’s frame-ancestors directive so this widget can embed on arbitrary third-party domains.

​

3. Iframe embed

<iframe
  src="https://your-org.nudj.cx"
  width="100%"
  height="640"
  frameborder="0"
  allow="camera; microphone; fullscreen">
</iframe>

​

CSP requirements

• Be embedded from a Shopify storefront domain — PR #1638 added Shopify hosts to the allowlist.
• Use the universal embed allowance — PR #2333 opened frame-ancestors for universal embedding.
• Ask your account manager to add your host to the organisation’s allowlist.

​

4. Mobile webview

import UIKit
import WebKit

class NudjViewController: UIViewController {
  var webView: WKWebView!

  override func loadView() {
    let config = WKWebViewConfiguration()
    webView = WKWebView(frame: .zero, configuration: config)
    view = webView
  }

  override func viewDidLoad() {
    super.viewDidLoad()
    let token = fetchNudjApiLinkToken() // server-issued
    let url = URL(string: "https://your-org.nudj.cx/api/link?token=\(token)")!
    webView.load(URLRequest(url: url))
  }
}

import android.webkit.WebView
import androidx.appcompat.app.AppCompatActivity

class NudjActivity : AppCompatActivity() {
  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    val webView = WebView(this)
    webView.settings.javaScriptEnabled = true
    val token = fetchNudjApiLinkToken() // server-issued
    webView.loadUrl("https://your-org.nudj.cx/api/link?token=$token")
    setContentView(webView)
  }
}

​

Picking a mode

​

Next steps

Last reviewed: 2026-04 · Related PRs: #1971, #2333, #1638