{"id":172,"date":"2026-07-08T09:55:42","date_gmt":"2026-07-08T09:55:42","guid":{"rendered":"https:\/\/www.marincas.net\/instant-search\/?page_id=172"},"modified":"2026-07-13T20:27:13","modified_gmt":"2026-07-13T20:27:13","slug":"documentation","status":"publish","type":"page","link":"https:\/\/www.marincas.net\/instant-search\/documentation\/","title":{"rendered":"Documentation"},"content":{"rendered":"\n<style data-wp-block-html=\"css\">\n.page-id-172 .entry-title, .page-id-172 .entry-header {display:none;}\n\n.isp-docs{--isp-blue:#1c74e8;--isp-ink:#2b3a42;--isp-muted:#5c6f78;--isp-line:#b9cec6;--isp-card:#ffffff;\n    max-width:68%!important;margin:0 auto;padding:24px 20px 90px;color:var(--isp-ink);\n    font-family:\"Segoe UI\",system-ui,-apple-system,sans-serif;line-height:1.65;}\n  .isp-docs *{box-sizing:border-box}\n  .isp-docs a{color:var(--isp-blue);text-decoration:none}\n  .isp-docs a:hover{text-decoration:underline}\n\n  \/* Page title *\/\n  .isp-docs .isp-hero{padding:40px 0 28px;border-bottom:2px solid var(--isp-ink);margin-bottom:48px}\n  .isp-docs .isp-hero h1{font-size:clamp(42px,7vw,84px);font-weight:200;margin:0 0 14px;letter-spacing:-1px}\n  .isp-docs .isp-hero p{max-width:640px;margin:0;font-size:18px;color:var(--isp-muted)}\n\n  \/* Layout: sticky sidebar + content *\/\n  .isp-docs .isp-grid{display:grid;grid-template-columns:230px 1fr;gap:56px;align-items:start}\n  .isp-docs .isp-toc{position:sticky;top:32px}\n  .isp-docs .isp-toc .isp-toc-label{font-size:12px;letter-spacing:2px;text-transform:uppercase;color:var(--isp-muted);margin-bottom:14px}\n  .isp-docs .isp-toc a{display:block;padding:7px 0 7px 14px;border-left:2px solid var(--isp-line);color:var(--isp-ink);font-size:15px}\n  .isp-docs .isp-toc a:hover{border-left-color:var(--isp-blue);color:var(--isp-blue);text-decoration:none}\n\n  \/* Sections *\/\n  .isp-docs section{margin-bottom:64px;scroll-margin-top:24px}\n  .isp-docs .isp-eyebrow{font-size:12px;letter-spacing:2px;text-transform:uppercase;color:var(--isp-blue);font-weight:600;margin-bottom:6px}\n  .isp-docs h2{font-size:30px;font-weight:300;margin:0 0 18px;letter-spacing:-.3px}\n  .isp-docs h3{font-size:19px;font-weight:600;margin:28px 0 10px}\n  .isp-docs p{margin:0 0 14px}\n  .isp-docs ol,.isp-docs ul{margin:0 0 16px;padding-left:22px}\n  .isp-docs li{margin-bottom:8px}\n\n  \/* Steps *\/\n  .isp-docs .isp-steps{counter-reset:step;list-style:none;padding:0;margin:0 0 8px}\n  .isp-docs .isp-steps li{counter-increment:step;position:relative;padding:0 0 22px 52px;margin:0}\n  .isp-docs .isp-steps li::before{content:counter(step);position:absolute;left:0;top:0;width:34px;height:34px;\n    border-radius:50%;background:var(--isp-blue);color:#fff;font-weight:600;font-size:15px;\n    display:flex;align-items:center;justify-content:center}\n  .isp-docs .isp-steps li:not(:last-child)::after{content:\"\";position:absolute;left:16px;top:38px;bottom:2px;width:2px;background:var(--isp-line)}\n  .isp-docs .isp-steps strong{display:block;margin-bottom:3px}\n\n  \/* Code + UI path *\/\n  .isp-docs code{background:var(--isp-card);border:1px solid var(--isp-line);border-radius:5px;padding:2px 7px;\n    font-family:Consolas,Menlo,monospace;font-size:.9em;color:#0f4fa8}\n  .isp-docs pre{background:#243036;color:#e8f0ee;border-radius:10px;padding:18px 20px;overflow-x:auto;\n    font-family:Consolas,Menlo,monospace;font-size:14px;line-height:1.55;margin:0 0 16px}\n  .isp-docs pre code{background:none;border:none;color:inherit;padding:0}\n  .isp-docs .isp-path{font-weight:600;color:var(--isp-ink)}\n  .isp-docs .isp-path span{color:var(--isp-muted);font-weight:400;padding:0 4px}\n\n  \/* Callouts *\/\n  .isp-docs .isp-note{background:var(--isp-card);border-left:4px solid var(--isp-blue);border-radius:0 10px 10px 0;\n    padding:14px 18px;margin:0 0 18px}\n  .isp-docs .isp-note strong{color:var(--isp-blue)}\n\n  \/* FAQ *\/\n  .isp-docs details{background:var(--isp-card);border:1px solid var(--isp-line);border-radius:10px;margin-bottom:10px;padding:0 18px}\n  .isp-docs summary{cursor:pointer;font-weight:600;padding:15px 0;list-style:none;position:relative;padding-right:28px}\n  .isp-docs summary::after{content:\"+\";position:absolute;right:2px;top:12px;font-size:20px;color:var(--isp-blue);font-weight:400}\n  .isp-docs details[open] summary::after{content:\"\u2013\"}\n  .isp-docs details p{padding-bottom:15px;margin:0;color:var(--isp-muted)}\n\n  \/* Footer CTA *\/\n  .isp-docs .isp-help{background:var(--isp-card);border:1px solid var(--isp-line);border-radius:14px;\n    padding:28px 30px;display:flex;flex-wrap:wrap;gap:18px;align-items:center;justify-content:space-between}\n  .isp-docs .isp-help p{margin:0}\n  .isp-docs .isp-btn{display:inline-block;background:var(--isp-blue);color:#fff;border-radius:8px;\n    padding:11px 24px;font-weight:600}\n  .isp-docs .isp-btn:hover{background:#1560c4;text-decoration:none}\n\n  @media (max-width:900px){\n    .isp-docs .isp-grid{grid-template-columns:1fr;gap:36px}\n    .isp-docs .isp-toc{position:static}\n    .isp-docs .isp-toc a{display:inline-block;border:1px solid var(--isp-line);border-radius:20px;\n      padding:6px 14px;margin:0 6px 8px 0;background:var(--isp-card)}\n  }\n<\/style>\n\n<div class=\"isp-docs\">\n <div class=\"isp-grid\">\n    <!-- Sidebar navigation -->\n    <nav class=\"isp-toc\">\n      <div class=\"isp-toc-label\">On this page<\/div>\n      <a href=\"#installation\">Installation<\/a>\n      <a href=\"#activation\">License activation<\/a>\n      <a href=\"#quick-setup\">Quick setup<\/a>\n      <a href=\"#settings\">Settings overview<\/a>\n      <a href=\"#voice-search\">Voice search<\/a>\n      <a href=\"#styling\">Styling &amp; custom CSS<\/a>\n      <a href=\"#updates\">Updates<\/a>\n      <a href=\"#faq\">FAQ &amp; troubleshooting<\/a>\n    <\/nav>\n\n    <!-- Main content -->\n    <div>\n\n      <section id=\"installation\">\n        <div class=\"isp-eyebrow\">Setup<\/div>\n        <h2>Installation<\/h2>\n        <p><strong>Requirements:<\/strong> WordPress 6.0 or newer, PHP 7.4 or newer. Instant Search PRO works with any properly coded theme, including Divi, Astra, GeneratePress, and block themes.<\/p>\n        <ol class=\"isp-steps\">\n          <li><strong>Download the plugin<\/strong> After purchase, download <code>instant-search-pro.zip<\/code> from your confirmation email.<\/li>\n          <li><strong>Upload to WordPress<\/strong> Go to <span class=\"isp-path\">Plugins <span>\u2192<\/span> Add New Plugin <span>\u2192<\/span> Upload Plugin<\/span>, choose the ZIP file, and click <em>Install Now<\/em>.<\/li>\n          <li><strong>Activate<\/strong> Click <em>Activate Plugin<\/em>. A new <strong>Instant Search PRO<\/strong> item appears in your admin menu.<\/li>\n        <\/ol>\n        <div class=\"isp-note\"><strong>Already using the free version?<\/strong> Instant Search PRO can be installed alongside it \u2014 your settings are carried over automatically. Once PRO is active, you can safely deactivate the free plugin.<\/div>\n      <\/section>\n\n      <section id=\"activation\">\n        <div class=\"isp-eyebrow\">Setup<\/div>\n        <h2>License activation<\/h2>\n        <p>Your license key unlocks PRO features and enables automatic updates.<\/p>\n        <ol class=\"isp-steps\">\n          <li><strong>Copy your license key<\/strong> You&#8217;ll find it in your purchase confirmation email.<\/li>\n          <li><strong>Open the license page<\/strong> Go to <span class=\"isp-path\">Instant Search PRO <span>\u2192<\/span> License<\/span>.<\/li>\n          <li><strong>Paste and activate<\/strong> Enter the key and click <em>Activate License<\/em>. A green confirmation means you&#8217;re all set.<\/li>\n        <\/ol>\n        <div class=\"isp-note\"><strong>Moving to a new site?<\/strong> Deactivate the license on the old site first, then activate it on the new one. If you ever get stuck, <a href=\"\/instant-search\/support\/\">contact support<\/a> and I&#8217;ll reset it for you.<\/div>\n      <\/section>\n\n      <section id=\"quick-setup\">\n        <div class=\"isp-eyebrow\">Setup<\/div>\n        <h2>Quick setup<\/h2>\n        <p>Out of the box, Instant Search PRO enhances your existing search forms \u2014 visitors start seeing live results as they type, with no extra configuration needed.<\/p>\n        <p>To review the defaults, go to <span class=\"isp-path\">Instant Search PRO <span>\u2192<\/span> Settings<\/span>. The most useful options to check first:<\/p>\n        <ul>\n          <li><strong>Post types<\/strong> \u2014 choose what gets searched: posts, pages, products, or custom post types.<\/li>\n          <li><strong>Results layout<\/strong> \u2014 list or grid, with or without thumbnails.<\/li>\n          <li><strong>Number of results<\/strong> \u2014 how many suggestions appear as the visitor types.<\/li>\n        <\/ul>\n        <p>You can also place a search form anywhere \u2014 in a page, sidebar, or footer \u2014 using the shortcode:<\/p>\n        <pre><code><div class=\"middleform\">\r\n    <form role=\"search\" style=\"display:inline-block;\" method=\"get\" id=\"searchform2\" action=\"https:\/\/www.marincas.net\/instant-search\/\">\r\n        <div class=\"search-wrapper2\">\r\n            <input type=\"text\" value=\"\" id=\"s2\" placeholder=\"Search...\" \/>\r\n                            <button type=\"button\" id=\"voice-search-btn2\" class=\"instant-voice-btn\" aria-label=\"Voice Search\">\r\n                                            <svg width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" aria-hidden=\"true\" focusable=\"false\">\r\n                            <path d=\"M12 14a3 3 0 0 0 3-3V7a3 3 0 1 0-6 0v4a3 3 0 0 0 3 3zM5 11a7 7 0 0 0 14 0M12 18v3\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\"\/>\r\n                        <\/svg>\r\n                                    <\/button>\r\n                        <button type=\"submit\" class=\"instant-search-submit\" aria-label=\"Search\">\r\n                                    <svg width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" aria-hidden=\"true\" focusable=\"false\">\r\n                        <path d=\"M21 21l-4.3-4.3M10 17a7 7 0 1 1 0-14 7 7 0 0 1 0 14z\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\"\/>\r\n                    <\/svg>\r\n                            <\/button>\r\n        <\/div>\r\n    <\/form>\r\n<\/div>\r\n<div id=\"myModal\" class=\"modal\" style=\"z-index:999;\">\r\n    <div class=\"modal-content\">      \r\n        <span class=\"close\" aria-label=\"Close\">&times;<\/span>\r\n        <div class=\"middleform\">\r\n            <form role=\"search\" style=\"display:inline-block;\" method=\"get\" id=\"searchform\" action=\"https:\/\/www.marincas.net\/instant-search\/\">\r\n                <div class=\"search-wrapper\">\r\n                    <input type=\"text\" value=\"\" name=\"s\" id=\"s\" placeholder=\"Search...\" \/>\r\n                                            <button type=\"button\" id=\"voice-search-btn\" class=\"instant-voice-btn\" aria-label=\"Voice Search\">\r\n                                                            <svg width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" aria-hidden=\"true\" focusable=\"false\">\r\n                                    <path d=\"M12 14a3 3 0 0 0 3-3V7a3 3 0 1 0-6 0v4a3 3 0 0 0 3 3zM5 11a7 7 0 0 0 14 0M12 18v3\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\"\/>\r\n                                <\/svg>\r\n                                                    <\/button>\r\n                                        <button type=\"submit\" class=\"instant-search-submit\" aria-label=\"Search\">\r\n                                                    <svg width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" aria-hidden=\"true\" focusable=\"false\">\r\n                                <path d=\"M21 21l-4.3-4.3M10 17a7 7 0 1 1 0-14 7 7 0 0 1 0 14z\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\"\/>\r\n                            <\/svg>\r\n                                            <\/button>\r\n                <\/div>\r\n                <input type=\"hidden\" name=\"post_type[]\" value=\"product\">\r\n            <\/form>\r\n            <div id=\"search-results\" class=\"list inline\"><\/div>\r\n        <\/div>\r\n    <\/div>\r\n<\/div>\r\n<script>\r\njQuery(function($) {\r\n    var modal = document.getElementById('myModal');\r\n    var btn   = document.getElementById('s2');\r\n    var span  = document.getElementsByClassName('close')[0];\r\n    if (btn) {\r\n        btn.onclick = function() {\r\n            if (window.instant_search && instant_search.search_method === 'overlay') {\r\n                modal.style.display = 'block';\r\n            } else {\r\n                $('#s2').trigger('input'); \r\n            }\r\n        };\r\n    }\r\n    if (span) {\r\n        span.onclick = function() { modal.style.display = 'none'; };\r\n    }\r\n    window.onclick = function(event) {\r\n        if (event.target === modal) { modal.style.display = 'none'; }\r\n    };\r\n});\r\n<\/script><\/code><\/pre>\n      <\/section>\n\n      <section id=\"settings\">\n        <div class=\"isp-eyebrow\">Configuration<\/div>\n        <h2>Settings overview<\/h2>\n        <h3>Search behavior<\/h3>\n        <p>Control how the live search responds: the minimum number of characters before results appear, the typing delay before a search fires, and whether to search in titles only or in full content and excerpts.<\/p>\n        <h3>Results appearance<\/h3>\n        <p>Choose whether results show featured images, excerpts, categories, and prices (for WooCommerce products). The results panel automatically adapts to your theme&#8217;s fonts and colors, and every part can be overridden \u2014 see <a href=\"#styling\">Styling &amp; custom CSS<\/a>.<\/p>\n        <h3>Exclusions<\/h3>\n        <p>Exclude specific posts, pages, categories, or entire post types from search results \u2014 useful for hiding thank-you pages, internal content, or out-of-stock products.<\/p>\n      <\/section>\n\n      <section id=\"voice-search\">\n        <div class=\"isp-eyebrow\">Configuration<\/div>\n        <h2>Voice search<\/h2>\n        <p>Instant Search PRO includes voice input powered by the browser&#8217;s built-in Web Speech API \u2014 no third-party service, no extra cost, and nothing is sent to external servers.<\/p>\n        <p>When enabled, a microphone icon appears inside the search field. Visitors tap it, speak, and their words are transcribed straight into the search box with live results appearing instantly.<\/p>\n        <div class=\"isp-note\"><strong>Browser support:<\/strong> voice input works in Chrome, Edge, and Safari. In browsers without Web Speech support (such as Firefox), the microphone icon is hidden automatically and the search field works normally.<\/div>\n      <\/section>\n\n      <section id=\"styling\">\n        <div class=\"isp-eyebrow\">Customization<\/div>\n        <h2>Styling &amp; custom CSS<\/h2>\n        <p>The results panel inherits your theme&#8217;s typography by default. For deeper customization, every element uses a stable, prefixed CSS class you can safely target. For example, to adjust the results panel and highlight color:<\/p>\n        <pre><code>\/* Round the results panel and soften its shadow *\/\n.instant-search-results {\n    border-radius: 12px;\n    box-shadow: 0 8px 30px rgba(0, 0, 0, .12);\n}\n\n\/* Change the matched-text highlight color *\/\n.instant-search-results mark {\n    background: #fff3bf;\n}<\/code><\/pre>\n        <p>Add snippets like these under <span class=\"isp-path\">Appearance <span>\u2192<\/span> Customize <span>\u2192<\/span> Additional CSS<\/span>, or in your theme&#8217;s custom CSS panel.<\/p>\n      <\/section>\n\n      <section id=\"updates\">\n        <div class=\"isp-eyebrow\">Maintenance<\/div>\n        <h2>Updates<\/h2>\n        <p>With an active license, updates arrive directly in your WordPress dashboard, exactly like plugins from the official repository. When a new version is available, you&#8217;ll see it under <span class=\"isp-path\">Dashboard <span>\u2192<\/span> Updates<\/span> \u2014 one click and you&#8217;re on the latest release.<\/p>\n        <p>Each release is listed in the changelog with what changed and why, so you always know what an update brings before installing it.<\/p>\n      <\/section>\n\n      <section id=\"faq\">\n        <div class=\"isp-eyebrow\">Help<\/div>\n        <h2>FAQ &amp; troubleshooting<\/h2>\n\n        <details>\n          <summary>Live results don&#8217;t appear when I type<\/summary>\n          <p>First, check for a JavaScript error from another plugin: open your browser console (F12 \u2192 Console) and look for red errors. Also make sure a caching or optimization plugin isn&#8217;t deferring the search script \u2014 excluding Instant Search PRO&#8217;s scripts from optimization usually solves it. If not, contact support with your site URL and I&#8217;ll take a look.<\/p>\n        <\/details>\n\n        <details>\n          <summary>Does it work with WooCommerce?<\/summary>\n          <p>Yes. Enable the Products post type in the settings and search results can include product thumbnails and prices, linking straight to the product page.<\/p>\n        <\/details>\n\n        <details>\n          <summary>Will it slow down my site?<\/summary>\n          <p>No. The plugin loads a single small script and stylesheet, and searches run through lightweight Ajax requests only while the visitor is actually typing. Nothing heavy loads on regular page views.<\/p>\n        <\/details>\n\n        <details>\n          <summary>Is it compatible with my theme?<\/summary>\n          <p>Instant Search PRO enhances the standard WordPress search form, so it works with any theme that follows WordPress conventions \u2014 including page builders like Divi and Elementor. If something looks off with your specific theme, send me the URL and I&#8217;ll provide the exact CSS fix.<\/p>\n        <\/details>\n\n        <details>\n          <summary>Can I use one license on multiple sites?<\/summary>\n          <p>Each license covers one production site. You can move it between sites at any time by deactivating it on the old site first. Staging and development sites don&#8217;t count against your activation.<\/p>\n        <\/details>\n      <\/section>\n\n      <div class=\"isp-help\">\n        <p><strong>Didn&#8217;t find what you need?<\/strong><br>Support is handled directly by the developer \u2014 no bots, no ticket queues.<\/p>\n        <a class=\"isp-btn\" href=\"\/instant-search\/support\/\">Contact support<\/a>\n      <\/div>\n\n    <\/div>\n  <\/div>\n<\/div>\n","protected":false},"excerpt":{"rendered":"<p>On this page Installation License activation Quick setup Settings overview Voice search Styling &amp; custom CSS Updates FAQ &amp; troubleshooting Setup Installation Requirements: WordPress 6.0 or newer, PHP 7.4 or newer. Instant Search PRO works with any properly coded theme, including Divi, Astra, GeneratePress, and block themes. Download the plugin After purchase, download instant-search-pro.zip from&hellip; <a class=\"more-link\" href=\"https:\/\/www.marincas.net\/instant-search\/documentation\/\">Continue reading <span class=\"screen-reader-text\">Documentation<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-172","page","type-page","status-publish","hentry","entry"],"_links":{"self":[{"href":"https:\/\/www.marincas.net\/instant-search\/wp-json\/wp\/v2\/pages\/172","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.marincas.net\/instant-search\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.marincas.net\/instant-search\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.marincas.net\/instant-search\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.marincas.net\/instant-search\/wp-json\/wp\/v2\/comments?post=172"}],"version-history":[{"count":9,"href":"https:\/\/www.marincas.net\/instant-search\/wp-json\/wp\/v2\/pages\/172\/revisions"}],"predecessor-version":[{"id":246,"href":"https:\/\/www.marincas.net\/instant-search\/wp-json\/wp\/v2\/pages\/172\/revisions\/246"}],"wp:attachment":[{"href":"https:\/\/www.marincas.net\/instant-search\/wp-json\/wp\/v2\/media?parent=172"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}