Skip to main content

Connect via feeds

Detailed step-by-step instructions for connecting Spefix via an XML product feed. Works for any platform.

⏱ Time: 15-20 minutes

Step 1: Sign up​

Via email​

  1. Go to spefix.com
  2. Click "Try for free" or "Log in" (in the top menu)
  3. Fill in the form:
    • Email — required
    • Phone number — required (so a manager can reach you)
    • Full name — optional
  4. Check your email → copy the password → log in to your dashboard

Via Google​

  1. Click "Sign in with Google"
  2. Choose your account
  3. Enter your phone number (required field)
  4. Done — you're in your dashboard

Step 2: Create a domain​

  1. In your dashboard, find the "Create domain" button (in the header)

Create domain button

  1. In the modal, enter your site's URL
    Example: https://myshop.com.ua

Create domain modal

  1. Click "Create"
Important

Enter the actual domain of the site you want to add search to. The widget will only work on that domain.

If you need search on several sites — create a separate domain for each.

Step 3: Prepare a product feed​

Spefix works with XML product feeds in two formats:

If you already have a feed for Google Shopping — it will work.

📖 Google Merchant feed requirements

Option 2: Spefix format​

You can create a feed following our own rules for better relevance.

📖 Spefix format

Where do I get a feed?

Usually the feed is generated automatically in your CMS:
Settings → Export → Google Merchant / Rozetka / Prom

Not sure what a feed is?

Or don't know where to get one? Contact our support team — we'll advise you and help you get a feed for your platform.

💬 Telegram: @spefix_pm • 📧 [email protected]

Step 4: Add the feed in Spefix​

  1. In your dashboard, go to: Search Settings → Integration
  2. Click "Add feed"

Add feed button

  1. Fill in the form:
    • Feed URL — a link to your XML file
      Example: https://myshop.com.ua/feed.xml
    • Feed language — choose from the list (Ukrainian, Russian...)

Feed upload form

  1. Click "Create"
Important

Enter the actual feed link generated by your CMS. Don't just append /feed.xml to your domain — that won't work.

The feed must be reachable at that link and contain XML data for your products.

Running into trouble?

Your language isn't in the list? Or the feed fails to add due to an error?

Contact support — we'll add the language individually and help you sort out feed errors.

💬 Telegram: @spefix_pm • 📧 [email protected]

Step 5: Wait for it to upload​

Once added, the feed will start uploading and indexing.

You can check the status in the Integration section:

  • Processing — the feed is uploading (5-15 min for large catalogs)
  • Ready — you can test the search
  • Error — contact your manager

Once the feed is uploaded, a "Demo" button will appear in your profile — you can test search on your products right in the dashboard.

Upload error?

If the feed fails to add — contact your manager on Telegram or via chat. We'll help you figure it out.

Step 6: Install the code on your site​

  1. Go to the "Integration" section
  2. Copy the widget code from your dashboard:

Field for copying the script

<script async src="https://smartsearch.spefix.com/spefix.js?token=YOUR_TOKEN&lang=uk"></script>
  1. Paste the code right before the closing </body> tag on your site
Important

Copy the code only from your own dashboard — a unique token is generated for each site. Code from examples won't work!

For multilingual sites​

If your site has multiple language versions, each one needs its own code with the matching lang= parameter:

  • Ukrainian version: lang=uk
  • Russian version: lang=ru
  • English version: lang=en

Example:

<!-- For the Ukrainian version -->
<script async src="https://smartsearch.spefix.com/spefix.js?token=YOUR_TOKEN&lang=uk"></script>

<!-- For the English version -->
<script async src="https://smartsearch.spefix.com/spefix.js?token=YOUR_TOKEN&lang=en"></script>
Having issues?

Not sure where to add the code, or running into errors? Contact support — we'll help with the installation.

💬 Telegram: @spefix_pm • 📧 [email protected]

Step 7: Configure the button selectors​

For the widget to open when a visitor clicks your search button, you need to specify that button's selector.

Find the button selector​

  1. Open your site
  2. Press F12 (developer console)
    Or right-click → "Inspect"

  1. Choose the "Select element" tool (arrow icon in the top-left corner)

  2. Click the search button on your site

  3. Find the class or id of that button in the code

Finding the selector in the code

Example selectors:

  • .search__input — class
  • #search-btn — ID

Add the selector in Spefix​

  1. Go to: Search Settings → Installation
  2. Find the block "List of selectors that open the widget on click"
  3. Click "Add selector"

Adding a selector in Spefix

  1. Enter your selector (e.g. .search__input)
  2. Click the checkmark to the right of the field (finish editing)
  3. If you have several search buttons — add each selector separately

Adding a selector in Spefix - step 2

Save your changes​

  1. Scroll down the page
  2. Click "Save" (the button appears after changes)

Save settings

Not sure about the selectors?

If you're having trouble finding or adding selectors — contact support. We'll help you find the right selectors or set them up for you.

💬 Telegram: @spefix_pm • 📧 [email protected]

Step 8: Verify it works​

  1. Open your site in an incognito tab (Ctrl+Shift+N / Cmd+Shift+N)
    This is needed to bypass the browser cache

  2. Click the search button → the Spefix widget should open ✅

  3. Try different search variations

Widget not opening?

Check in an incognito tab — cached changes may not show up right away due to the browser cache.

Still not working? Contact your manager — we'll help you configure the selectors.

Done! 🎉​

Spefix is now working on your site.

What's next?​

Need help?​

💬 Telegram: @spefix_pm
📧 Email: [email protected]

Your personal manager will advise, help with configuration, or set up the search for you.

Trial period

14 days free — no card required, cancel anytime