Integrate WebSign in iframe

After sending the envelope, you can obtain the signing URL for the current signer (or for all signers in bulk mode) by calling the "GetEnvelopeDetails" API method. The response contains the URL in a property called "SigningUrl".

Our recommended definition for the iframe definition markup is :

<iframe sandbox="allow-same-origin allow-scripts allow-popups allow-forms" src="" >

Also please remember the bigger the iframe size, the better the user experience will be. See also the Github sample

Receive signing events when integrating Websign in iframe

When hosting the signing application in a iframe is possible to also receive the same client side custom events as when extending directly the signing application.

To enable triggering these events you must enable the "Trigger events when integrating WebSign in a iframe" option located in Signing Settings.

How are the events dispatched ?

To receive the events you must subscribe to the "message" event, like this :

      window.addEventListener('message', function(event) {
                console.log('received message: ',;
            }, false);
  • the events are dispatched as JSON strings with the following format
   {"event" : "DocumentsLoaded"}

If the events contains parameters, they will be added to the JSON starting with index 0 , like this :

{"0": "113-2345-5454432-234212", "event" : "Signed"}

Please note that due to the blocking on 3rd party cookies by default in latest browser versions, our recommandation for integration is to redirect to WebSign instead of using an iframe.