Dashboard

Product Import

Import and sync your product catalog with SearchX.


Overview

SearchX imports products from XML feeds into a search index. The import process validates your feed, parses product data, and creates a searchable index optimized for fast retrieval.


Supported Feed Formats

FormatDescriptionGuide
Google MerchantRSS 2.0 format used by Google ShoppingSetup Guide
Facebook CatalogAtom format used by Facebook/Instagram ShoppingSetup Guide
SkroutzCustom format used by Skroutz.grSetup Guide

Import Process

1. Feed Validation

Before importing, SearchX validates your feed:

  • Checks that the URL is accessible.
  • Verifies the XML structure matches the selected feed type.
  • Validates required fields for each product.

2. Product Parsing

Products are extracted from the feed and mapped to SearchX's internal schema:

  • Title, description, and other text fields are indexed for search.
  • Numeric fields (price, etc.) are indexed for filtering and sorting.
  • Images and URLs are stored for display.

3. Indexing

Parsed products are added to the search index with:

  • Full-text search capabilities.
  • Faceted filtering support.
  • Typo tolerance and synonym handling.

Custom Filters from Your Feed

Feeds often carry extra product details beyond the standard fields: custom tags such as <ram> or <material>, g:product_detail, attribute blocks, and custom_label_0 to custom_label_4. SearchX finds them on every import and lists them under Settings → Feed, in the Feed attributes section, with a suggestion for each one.

Nothing reaches your storefront on its own. You choose which details become filters:

  1. Open Applications > your app > Settings > Feed and scroll to Feed attributes.
  2. Enable the attributes you want as filters. SearchX suggests the ones that look like good filters; attributes that too few products have, or whose values are mostly unique, are not suggested.
  3. Edit an attribute to set its storefront title in each language, how values that hold several options are split (for example Black, Silver), and how its values are ordered: by number of products, A to Z, Z to A, or your own order.
  4. Choose how the filter is shown: Pin to top places it above the standard filters (Brand, Price, ...), Searchable value list lets shoppers type to find a value in long lists, and Collapsed by default starts it closed.

Saving re-indexes the application's products so the new values are searchable and filterable. An attribute missing from your latest import keeps its settings, and its filter stays hidden until the feed contains it again.


Variants: One Result per Product

Google and Facebook feeds usually list each size or colour as its own item. If those variants share one product page URL, turn on Group product variants under Settings → Content → Product Visibility to show one result per product page instead of one per variant. Changing it rebuilds the search index.

The same section can hide out-of-stock products and products with a price of zero.


Re-importing Products

To update your product catalog:

  1. Go to Applications > your app > Products.
  2. Click Import Products.
  3. SearchX will fetch the latest version of your feed and update the index.

Automatic Updates

You don't have to re-import by hand every time your catalog changes. Set up scheduled imports in your application settings and SearchX fetches your feed automatically at the interval you choose.


Troubleshooting

  • Import failed: Check that your feed URL is accessible and the XML is well-formed.
  • Missing products: Ensure all required fields are present in your feed.
  • Stale data: Re-import your products to get the latest catalog data.
Previous
Application Management