Embedding Voxpopme into your survey

Voxpopme Help Team UK -

Follow this how-to guide to embed the Voxpopme capture widget into your survey platform. There are two essential parts to include on the video question page in your survey, a Javascript element and a HTML element. The guide below will walk you through how to embed both into your platform.

  1. Copy the embed code below as Javascript into your survey platform, on the page you would like to add the capture widget:

    var vpm_widget_config = {
        project_id: "[project_id]",
        additional_data: {
    	'first_name': '[first_name]',
    	'Age': '[Age]',
    	'NPS': '[NPS]'
        settings: {
    	locale: "en_GB"
        disable_next_button: function() {
    	// Insert disable 'Next' button function appropriate to your survey platform here
        enable_next_button: function() {
    	// Insert enable 'Next' button function appropriate to your survey platform here
    !function(a,b,c,d){function e(){var a=b.createElement(c);a.type="text/javascript",a.async=!0,a.src=d;var e=b.getElementsByTagName(c)[0];e.parentNode.insertBefore(a,e)}a.attachEvent?a.attachEvent("onload",e):a.addEventListener("load",e,!1)}(window,document,"script","https://capture.voxpopme.net/main.js");
    document.addEventListener("DOMContentLoaded", function(event) {
        // Replace your_NextButton below with the appropriate function to disable 'Next' button in your survey platform 
    document.getElementById("your_NextButton").style.display = "none";
        // Replace your_checkbox is your survey platform's class for selection a checkbox 
        var checkbox = document.getElementsByClassName("your_checkbox")[0];
        checkbox.onchange = function(){
            if (checkbox.checked){
                // Insert enable 'Next' button function appropriate to your survey platform here
            } else {
                // Insert disable 'Next' button function appropriate to your survey platform here
  2. Replace the Project ID with the ID that has been provided to you by a member of the Voxpopme team. This is also available in the Voxpopme portal. To access this ID, head to the portal, select your project and use the Responses drop-down to select Summary.
  3. If you're setting up a non-English language survey, ensure you've changed the Locale code. This will notify the system of the language that responses are expected to be in. Check out the list of languages available.
  4. Replace the Javascript comments noted within the embed code with the appropriate functions for hiding and showing the 'Next' button, as well as the checkbox selection within your survey platform. This will ensure respondents cannot skip past recording without uploading a response, and that they are able to move smoothly through the survey if they have any technical difficulties.
  5. Save your Javascript. 
  6. Insert a text description on the video question page in your survey, paste the below in:
    <div class="vpm-capture-widget"></div>
    This will tell the survey platform where to place the video capture widget on the page. 

To ensure a high conversion rate of video responses, we have a couple of pointers:

  • Ensure the disabling and enabling of the 'Next' button is working correctly when testing through.
  • Add an 'I'm having technical difficulties or would no longer like to record' checkbox below the capture widget. If the respondent selects this option, confirm the 'Next' button enables and that they are routed to a textbox question or terminated. 
  • We recommend including recording instructions on the video question page. Voxpopme produces template instructions which can be shared with you.
  • Make sure you've asked the respondent to opt-in for the video question, and that they're aware of how their video response may be used. We suggest inserting a pre-video question page that will ask the respondent if they would like to proceed with recording a video response. We have recommended opt-in text we'd be happy to share.
  • See our full embed guide for all of our video best practices. 


If you have any questions, please contact the Voxpopme team. When your survey is ready, it would be great if you could share a test link with the Voxpopme team so we can ensure everything is working correctly.

Have more questions? Submit a request


Article is closed for comments.