guide · embed

embed the widget

one script tag is all it takes. from zero to a live ai copilot on your site in under five minutes — no npm, no build step, no sdk.

  1. 01

    get your workspace id

    sign up at aside.ai , create a workspace, then open the embed tab in workspace settings. your workspace id looks like ws_abc123 . copy it — you'll need it in the next step.

  2. 02

    add the script tag

    paste this one line into the <body> of your page, replacing YOUR_WORKSPACE_ID with the value from step 1. the widget button appears automatically.

    html

    <script
  src="https://cdn.aside.ai/widget.js"
  data-workspace="YOUR_WORKSPACE_ID">
</script>

  3. 03

    customize the button

    three optional data attributes let you match your brand. position can be bottom-right , bottom-left , top-right , or top-left . color accepts any hex value. label is the tooltip shown on hover.

    html

    <script
  src="https://cdn.aside.ai/widget.js"
  data-workspace="YOUR_WORKSPACE_ID"
  data-position="bottom-right"
  data-color="#6d8fff"
  data-label="need help?">
</script>

  4. 04

    pass user identity (optional)

    if you add identity attributes, aside associates sessions with real users in your dashboard — helpful for support handoffs and session replay. for production, use a signed jwt (hs256, signed with your workspace secret) so the identity cannot be spoofed.

    html

    <!-- plain identity -->
<script
  src="https://cdn.aside.ai/widget.js"
  data-workspace="YOUR_WORKSPACE_ID"
  data-user-id="usr_123"
  data-email="[email protected]">
</script>

<!-- secure identity (recommended for production) -->
<script
  src="https://cdn.aside.ai/widget.js"
  data-workspace="YOUR_WORKSPACE_ID"
  data-jwt="eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...">
</script>

  5. 05

    configure consent (optional)

    if your users are in the eu or gdpr applies to you, enable the consent banner in workspace settings → privacy. when enabled, users see a clear checkbox before screen share starts — the agent will not begin until they accept. the setting is off by default because many b2b tools prefer to obtain consent during their own onboarding flow.

    dashboard path

    workspace settings → privacy → enable consent banner

  6. 06

    test it

    open your site in chrome or edge. click the aside widget button in the corner. choose a tab to share. the agent will greet you in under three seconds and start narrating what it sees. if the button doesn't appear, check that your workspace id is correct and the script tag is in the <body> , not the <head> .

    01

    click the button

    02

    share your screen

    03

    talk to the agent

what's next

guide · flows

create guided flows

set up triggers and step-by-step flows so the agent proactively walks users through onboarding.

read →

guide · integrations

set up integrations

connect jira, zendesk, and slack so handoffs are automatic and context-complete.

read →
need help? book a pilot →