Findify Developer Hub

Welcome to the Findify developer hub. You'll find comprehensive guides and documentation to help you start working with Findify as quickly as possible, as well as support if you get stuck. Let's jump right in!

Shopify Integration: Minimum set of permissions

Integrating Shopify with minimum set of permissions

If you have given the full set of permissions to the API key you have provided, you can skip this guide!

If you have chosen to give us the minimum set of permissions you will need to follow this guide to finish setting up Findify in your store.

  • Tag product view
  • Create search results page
  • Add script to <head> section

Tag product view

Create a new snippet under snippets/ that is called findify-tagging.liquid with the following content

{% if product %}
  <div data-findify-event="view-page" data-findify-item-id="{{}}" data-findify-variant-item-id="{{}}"></div>
  <div data-findify-filter="category" data-findify-filter-value='{{product.type | escape}}'></div>
  <div data-findify-filter="brand" data-findify-filter-value='{{product.vendor | escape}}'></div>
  <div data-findify-filter="id" data-findify-filter-value='{{}}'></div>
{% endif %}

{% if cart %} 
  <div data-findify-event="update-cart">
    {% for item in cart.items %}
      <div data-findify-item-id="{{ item.product_id }}" data-findify-variant-item-id="{{item.variant_id}}" data-findify-unit-price="{{ item.price | money_without_currency }}" data-findify-quantity="{{ item.quantity }}"></div>
    {% endfor %}

  <div data-findify-filter="id" data-findify-filter-value='[{% for item in cart.items %} { "value": [{{ item.product_id }}] } {% if forloop.last == false %},{%endif%}{% endfor %}]'></div>
{% endif %}

Reference this snippet in theme.liquid file of the theme by placing the snippet below before </body>

{% include 'findify-tagging' %}

Create search results page

  • Go the the Pages section on the left
  • Create a new page for displaying search results with search-results handle
  • Put the following content there by clicking on Show HTML button
<style>.findify-component-spinner,.findify-component-spinner:after{border-radius:50%;width:60px;height:60px}.findify-component-spinner{margin:60px auto 0!important;position:relative;-webkit-transform:translateZ(0);-ms-transform:translateZ(0);transform:translateZ(0);-webkit-animation:findify-component-spinner-animation .7s infinite cubic-bezier(.67,.35,.7,.8);animation:findify-component-spinner-animation .7s infinite cubic-bezier(.67,.35,.7,.8);-ms-transform-origin:50% 50%;-webkit-transform-origin:50% 50%;transform-origin:50% 50%;border-top:3px solid #eaeaea;border-right:3px solid #eaeaea;border-bottom:3px solid #eaeaea;border-left:3px solid #c6c6c6}@-webkit-keyframes findify-component-spinner-animation{0%{-webkit-transform:rotate(90deg);transform:rotate(90deg)}100%{-webkit-transform:rotate(450deg);transform:rotate(450deg)}}@keyframes findify-component-spinner-animation{0%{-webkit-transform:rotate(90deg);transform:rotate(90deg)}100%{-webkit-transform:rotate(450deg);transform:rotate(450deg)}}</style>
<div id="findify_results" style="min-height: 400px;">
  <div class="findify-component-spinner"></div>

Add script to <head> section

Go to the Findify Integration section of the Merchant Dashboard and copy the script.

Paste the script into theme.liquid file after <head> tag.

After following these steps the search should be live in your store!

Updated 11 months ago

Shopify Integration: Minimum set of permissions

Integrating Shopify with minimum set of permissions

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.