If your website or web app is protected (e.g with Cloudflare or similar), behind a firewall, or require users to be authenticated, you will need additional settings when setting up Usersnap.
To get these accurate screenshots, we are storing the HTML when your users are taking a screenshot in a feedback item. But to accurately render them, our rendering-servers need access to your web pages to have access to the CSS and JavaScript files embedded in the HTML.
If your website or web application is protected by a firewall or a script, you and your technical team need to make sure that these resources (CSS, JavaScript) are available for our rendering servers.
If your site requires basic authentication (.htaccess), you need to grant access to the Usersnap servers (*.usersnap.com).
Configuration for Apache 2.2
Order deny,allow
Deny from all
AuthType Basic
AuthName "Password protected"
Require valid-user
AuthUserFile /path/to/your/.htpasswd
Allow from .usersnap.com
Satisfy Any
Open the IIS Manager, click on your website and open "IP address and domain restrictions". In this view, enable domain restrictions (Edit Feature Settings | Enable domain restrictions) and add an allow rule for the domain "*.usersnap.com".
","html_footer":"","html_body":"","html_promo":"\n Go to the Guides\n","javascript_hub2":"window.onUsersnapLoad = function(api) {\n api.init();\n };\n var script = document.createElement('script');\n script.defer = 1;\n script.src = 'https://widget.usersnap.com/global/load/ef0e60ee-2401-4479-884e-8e593d9b40f8?onload=onUsersnapLoad';\n document.getElementsByTagName('head')[0].appendChild(script);","javascript":"","stylesheet_hub2":"@import url('https://fonts.googleapis.com/css?family=Roboto:300,400');\n\nbody {\n font-family: Roboto,Arial,Helvetica,sans-serif;\n /*font-size: 18px;\n line-height: 1.5em;*/\n color: #000;\n -webkit-font-smoothing: antialiased;\n}\n\n.theme-solid #hub-landing-top h2, .theme-solid #hub-landing-top .hub-landing-description p {\n color: #fff;\n align-content: center;\n text-align: center;\n}\n\nul>li {\n \t\tfont-size: 16px; \n}\n#hub-sidebar-content ul>li>a {\n\t\tcolor: #666666b8;\n \tfont-size: 13px;\n}\n\np {\n \t font-family: Roboto,Arial,Helvetica,sans-serif;\n font-size: 16px;\n /*line-height: 1.5em;*/\n -webkit-font-smoothing: antialiased;\n}\n\n.heading.heading .heading-text { \n font-weight: 700;\n}\n\n.heading.heading {\n\tmargin-top: 40px;\n}\n\n#hub-sidebar-content h3 {\n color: #3a21cec7;\n}","stylesheet":"","favicon":["https://files.readme.io/16db8f9-small-UsersnapIconWhite.png","UsersnapIconWhite.png",32,32,"#ffffff","https://files.readme.io/814988f-UsersnapIconWhite.png"],"logo_white_use":false,"logo_white":["https://files.readme.io/d3578c5-small-usersnap_white.png","usersnap_white.png",428,80,"#ffffff","https://files.readme.io/4fa2061-usersnap_white.png"],"logo":["https://files.readme.io/4aa94ca-small-usersnap_white.png","usersnap_white.png",428,80,"#ffffff","https://files.readme.io/44315c2-usersnap_white.png"],"promos":[{"extras":{"type":"html","buttonPrimary":"get-started","buttonSecondary":"none"},"title":"Hi! How can we help you?","text":"Thanks for choosing Usersnap to help your company collect and manage user feedback to build better products. Getting started with Usersnap is easy. Just check our help center.","_id":"599e9484d222c9000fe2efe2"}],"body":{"style":"none"},"header":{"img_pos":"tl","img_size":"auto","img":[],"style":"solid","linkStyle":"buttons"},"typography":{"tk_body":"","tk_headline":"","tk_key":"","typekit":false,"body":"Open+Sans:400:sans-serif","headline":"Open+Sans:400:sans-serif"},"colors":{"body_highlight":"","header_text":"","main_alt":"#289CE4","main":"#3a21ce","highlight":"","custom_login_link_color":""},"main_body":{"type":"links"},"categoriesAsDropdown":false,"hide_logo":false,"sticky":false,"landing":true,"overlay":"triangles","notheme":false,"theme":"solid","link_logo_to_url":false,"referenceLayout":"row","childrenAsPills":false,"global_landing_page":{"html":"","redirect":""},"rdmd":{"callouts":{"useIconFont":false},"theme":{"background":"","border":"","markdownEdge":"","markdownFont":"","markdownFontSize":"","markdownLineHeight":"","markdownRadius":"","markdownText":"","markdownTitle":"","markdownTitleFont":"","mdCodeBackground":"","mdCodeFont":"","mdCodeRadius":"","mdCodeTabs":"","mdCodeText":"","tableEdges":"","tableHead":"","tableHeadText":"","tableRow":"","tableStripe":"","tableText":"","text":"","title":""}},"splitReferenceDocs":false,"subheaderStyle":"links","showMetricsInReference":true,"referenceSimpleMode":true,"stylesheet_hub3":"","loginLogo":[],"logo_large":false,"colorScheme":"light","changelog":{"layoutExpanded":false,"showAuthor":true,"showExactDate":false},"allowApiExplorerJsonEditor":false,"ai_dropdown":"disabled","ai_options":{"chatgpt":"enabled","claude":"enabled","clipboard":"enabled","view_as_markdown":"enabled","copilot":"enabled"},"showPageIcons":true,"layout":{"full_width":false,"style":"classic"}},"custom_domain":"help.usersnap.com","childrenProjects":[],"derivedPlan":"startup","description":"Usersnap helps your business with its versatile feedback platform to build better, more successful products and services with the help of user feedback. Getting started with Usersnap is easy.","isExternalSnippetActive":false,"error404":"","experiments":[],"first_page":"landing","flags":{"cacheEnabled":true,"allowImport":false,"stripe":false,"hideGoogleAnalytics":false,"jwt":false,"cookieAuthentication":false,"allowXFrame":false,"speedyRender":false,"correctnewlines":false,"swagger":false,"oauth":false,"migrationSwaggerRun":false,"migrationRun":false,"hub2":true,"enterprise":false,"allow_hub2":false,"newApiExplorer":true,"alwaysShowDocPublishStatus":false,"directGoogleToStableVersion":false,"disableAnonForum":false,"newEditor":true,"newMarkdownBetaProgram":true,"oldMarkdown":false,"translation":false,"newSearch":true,"allowApiExplorerJsonEditor":false,"rdmdCompatibilityMode":false,"staging":false,"tutorials":true,"useReactApp":true,"newHeader":false,"referenceRedesign":false,"auth0Oauth":false,"graphql":false,"singleProjectEnterprise":false,"dashReact":false,"allowReferenceUpgrade":true,"metricsV2":true,"newEditorDash":true,"enableRealtimeExperiences":false,"reviewWorkflow":true,"star":false,"allowDarkMode":false,"forceDarkMode":false,"useReactGLP":false,"disablePasswordlessLogin":false,"personalizedDocs":false,"myDevelopers":false,"superHub":true,"developerDashboard":false,"allowReusableOTPs":false,"dashHomeRefresh":false,"owlbotAi":false,"apiV2":false,"git":{"read":false,"write":false},"superHubBeta":false,"dashQuickstart":false,"disableAutoTranslate":false,"customBlocks":false,"devDashHub":false,"disableSAMLScoping":false,"allowUnsafeCustomHtmlSuggestionsFromNonAdmins":false,"apiAccessRevoked":false,"passwordlessLogin":"default","disableSignups":false,"billingRedesignEnabled":true,"developerPortal":false,"mdx":true,"superHubDevelopment":false,"annualBillingEnabled":true,"devDashBillingRedesignEnabled":false,"enableOidc":false,"customComponents":false,"disableDiscussionSpamRecaptchaBypass":false,"developerViewUsersData":false,"changelogRssAlwaysPublic":false,"bidiSync":true,"superHubMigrationSelfServeFlow":true,"apiDesigner":false,"hideEnforceSSO":false,"localLLM":false,"superHubManageVersions":false,"gitSidebar":false,"superHubGlobalCustomBlocks":false,"childManagedBidi":false,"superHubBranches":false,"externalSdkSnippets":false,"migrationPreview":false,"requiresJQuery":false,"superHubPreview":false,"superHubBranchReviews":false,"superHubMergePermissions":false},"fullBaseUrl":"https://help.usersnap.com/","git":{"migration":{"createRepository":{"start":"2025-05-07T21:35:05.840Z","end":"2025-05-07T21:35:06.270Z","status":"successful"},"transformation":{"end":"2025-05-07T21:35:07.026Z","start":"2025-05-07T21:35:06.449Z","status":"successful"},"migratingPages":{"end":"2025-05-07T21:35:08.105Z","start":"2025-05-07T21:35:07.113Z","status":"successful"},"enableSuperhub":{"start":"2025-05-07T22:22:58.974Z","status":"successful","end":"2025-05-07T22:22:58.975Z"}},"sync":{"linked_repository":{},"installationRequest":{},"connections":[],"providers":[]}},"glossaryTerms":[],"graphqlSchema":"","gracePeriod":{"enabled":false,"endsAt":null},"shouldGateDash":false,"healthCheck":{"provider":"","settings":{}},"intercom_secure_emailonly":false,"intercom":"rycucve3","is_active":true,"integrations":{"login":{}},"internal":"","jwtExpirationTime":0,"landing_bottom":[{"type":"html","alignment":"left","html":""},{"type":"docs","alignment":"left","pageType":"Documentation","mediaHTML":"\n\n"}},"header":{"type":"solid","gradient_color":"#289CE4","link_style":"buttons","overlay":{"fill":"auto","type":"triangles","position":"top-left","image":{"uri":null,"url":null,"name":null,"width":null,"height":null,"color":null,"links":{"original_url":null}}}},"ai":{"dropdown":"disabled","options":{"chatgpt":"enabled","claude":"enabled","clipboard":"enabled","copilot":"enabled","view_as_markdown":"enabled"}},"navigation":{"first_page":"landing_page","left":[],"logo_link":"landing_page","page_icons":"enabled","right":[{"type":"link_url","title":"Back to the USERSNAP website","url":"https://usersnap.com/?gat=from_help","custom_page":"my-custom"}],"sub_nav":[],"subheader_layout":"links","version":"disabled","links":{"home":{"label":"Home","visibility":"enabled"},"graphql":{"label":"GraphQL","visibility":"disabled"},"guides":{"label":"Guides","alias":null,"visibility":"enabled"},"reference":{"label":"API Reference","alias":null,"visibility":"enabled"},"recipes":{"label":"Recipes","alias":null,"visibility":"disabled"},"changelog":{"label":"Changelog","alias":null,"visibility":"disabled"},"discussions":{"label":"Discussions","alias":null,"visibility":"disabled"}}}},"git":{"connection":{"repository":{},"organization":null,"status":"inactive"}}}},"version":{"_id":"628b36b6b299dc0086085dc6","version":"9.0","version_clean":"9.0.0","codename":"","is_stable":true,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["628b36b6b299dc0086085d1d","5fc4d2113a54af0075533274","5fc4d2113a54af0075533275","628b36b6b299dc0086085d1e","628b36b6b299dc0086085d1f","628b36b6b299dc0086085d20","628b36b6b299dc0086085d21","60097f082932a600681ec667","628b36b6b299dc0086085d22","628b36b6b299dc0086085d23","628b36b6b299dc0086085d24","628b3725d9ab60003d1a2192","628b3af97e960f00a7aab41d","628b3b40374387009c88fadf","628b4dfc4777730316beb778","628b4e1489f01b0093690451","628b4e7a9475e40083264d55","628b4ebe7a046000a8aba25e","628b4f0070b62500130ccf1d","628b4f9a58f033008d9761f0","628b5195d286df002f10f3b4","62987de6d38e7b001a9207a2","6299c63bb0a8e6005de970ff","6299d658ca5c23050909a0e4","6299e67e77e52600f595fcdc","62a6dbe236263e0027560f86","62a780db785b980220e18139","62e3c01274412b04874c0226","6376bee8127d990003169eb2","638093e300414606534e656b","6463bdd9245d8d003d5731b6","64c8bce46011ec000a37ceab","66c71fbcd78f8600448e5fb1"],"project":"599e9484d222c9000fe2efe1","__v":2,"forked_from":"61eadd71f04b94021238f0dc","createdAt":"2017-08-24T08:55:32.695Z","releaseDate":"2017-08-24T08:55:32.695Z","updatedAt":"2024-08-22T11:23:40.486Z","apiRegistries":[],"pdfStatus":"","source":"readme"}},"is404":false,"isDetachedProductionSite":false,"lang":"en","langFull":"Default","reqUrl":"/docs/usersnap-protected","version":{"_id":"628b36b6b299dc0086085dc6","version":"9.0","version_clean":"9.0.0","codename":"","is_stable":true,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["628b36b6b299dc0086085d1d","5fc4d2113a54af0075533274","5fc4d2113a54af0075533275","628b36b6b299dc0086085d1e","628b36b6b299dc0086085d1f","628b36b6b299dc0086085d20","628b36b6b299dc0086085d21","60097f082932a600681ec667","628b36b6b299dc0086085d22","628b36b6b299dc0086085d23","628b36b6b299dc0086085d24","628b3725d9ab60003d1a2192","628b3af97e960f00a7aab41d","628b3b40374387009c88fadf","628b4dfc4777730316beb778","628b4e1489f01b0093690451","628b4e7a9475e40083264d55","628b4ebe7a046000a8aba25e","628b4f0070b62500130ccf1d","628b4f9a58f033008d9761f0","628b5195d286df002f10f3b4","62987de6d38e7b001a9207a2","6299c63bb0a8e6005de970ff","6299d658ca5c23050909a0e4","6299e67e77e52600f595fcdc","62a6dbe236263e0027560f86","62a780db785b980220e18139","62e3c01274412b04874c0226","6376bee8127d990003169eb2","638093e300414606534e656b","6463bdd9245d8d003d5731b6","64c8bce46011ec000a37ceab","66c71fbcd78f8600448e5fb1"],"project":"599e9484d222c9000fe2efe1","__v":2,"forked_from":"61eadd71f04b94021238f0dc","createdAt":"2017-08-24T08:55:32.695Z","releaseDate":"2017-08-24T08:55:32.695Z","updatedAt":"2024-08-22T11:23:40.486Z","apiRegistries":[],"pdfStatus":"","source":"readme"},"gitVersion":{"base":"7.0","display_name":null,"name":"9.0","release_stage":"release","source":"readme","state":"current","updated_at":"2025-07-17T11:46:40.000Z","uri":"/branches/9.0","privacy":{"view":"default"}},"versions":{"total":13,"page":1,"per_page":100,"paging":{"next":null,"previous":null,"first":"/usersnap/api-next/v2/branches?page=1&per_page=100","last":null},"data":[{"base":null,"display_name":null,"name":"1.0","release_stage":"release","source":"readme","state":"current","updated_at":"2025-05-18T11:55:16.881Z","uri":"/branches/1.0","privacy":{"view":"hidden"}},{"base":"1.0","display_name":null,"name":"2.0","release_stage":"release","source":"readme","state":"current","updated_at":"2025-05-18T11:57:22.813Z","uri":"/branches/2.0","privacy":{"view":"hidden"}},{"base":"2.0","display_name":"QA & Rating projects","name":"3.0","release_stage":"release","source":"readme","state":"current","updated_at":"2025-05-18T11:58:59.767Z","uri":"/branches/3.0","privacy":{"view":"hidden"}},{"base":"3.0","display_name":"Improved help","name":"4.0","release_stage":"release","source":"readme","state":"current","updated_at":"2025-05-18T12:00:22.149Z","uri":"/branches/4.0","privacy":{"view":"hidden"}},{"base":"3.0","display_name":"Test version - will be deleted","name":"4.9","release_stage":"release","source":"readme","state":"current","updated_at":"2025-05-18T12:01:13.266Z","uri":"/branches/4.9","privacy":{"view":"hidden"}},{"base":"4.0","display_name":"New version 2021-02-02","name":"5.0","release_stage":"release","source":"readme","state":"current","updated_at":"2025-05-18T12:04:13.065Z","uri":"/branches/5.0","privacy":{"view":"hidden"}},{"base":"5.0","display_name":"New version 2021-02-02","name":"6.0","release_stage":"release","source":"readme","state":"current","updated_at":"2025-05-18T12:05:36.254Z","uri":"/branches/6.0","privacy":{"view":"hidden"}},{"base":"6.0","display_name":"platform","name":"7.0","release_stage":"release","source":"readme","state":"current","updated_at":"2025-05-18T12:06:52.009Z","uri":"/branches/7.0","privacy":{"view":"hidden"}},{"base":"7.0","display_name":"New navigation June, 2022","name":"8.0","release_stage":"release","source":"readme","state":"current","updated_at":"2025-05-18T12:07:19.929Z","uri":"/branches/8.0","privacy":{"view":"hidden"}},{"base":"7.0","display_name":null,"name":"9.0","release_stage":"release","source":"readme","state":"current","updated_at":"2025-07-17T11:46:40.647Z","uri":"/branches/9.0","privacy":{"view":"default"}},{"base":"9.0","display_name":null,"name":"10.0","release_stage":"release","source":"readme","state":"current","updated_at":"2025-05-18T12:08:12.606Z","uri":"/branches/10.0","privacy":{"view":"hidden"}},{"base":"9.0","display_name":null,"name":"10.1","release_stage":"release","source":"readme","state":"current","updated_at":"2025-05-15T07:38:15.609Z","uri":"/branches/10.1","privacy":{"view":"public"}},{"base":"9.0","display_name":"new install by Marcin","name":"11","release_stage":"release","source":"readme","state":"current","updated_at":"2025-05-18T12:09:20.618Z","uri":"/branches/11","privacy":{"view":"hidden"}}],"type":"version"}}">