Help & Docs

Intro

Everything you need to install Nexology, add it to your Shopify theme, test that it works, and get support. Step-by-step instructions are below. Video walkthroughs are coming soon. In the meantime, if you would like a live demo or a hand on the install, email support@nexology.co.uk and we will book you in.

Quick start

Installing the app

Open the Nexology Fashion Intelligence listing on the Shopify App Store and click Add app. Shopify will ask you to approve the requested permissions. These are the standard read scopes Nexology needs to see your product catalogue plus the write scopes needed to display the widget. After approval, the app installs and the Nexology admin opens automatically inside your Shopify admin.

The first thing you will see is a catalogue processing progress bar. Two phases run in sequence.

Phase A: product import

Nexology reads every product, image, tag, and variant from your store.

Phase B: AI analysis

Two fashion-trained AI models analyse every product. Visual AI understands aesthetic feel. Text AI understands fashion language across more than 100 languages.

You can leave the admin tab open or come back later. Processing continues in the background.

Adding Similar Vibe to your product pages

Similar Vibe is the visual recommendations widget that appears on product detail pages. You add it as a section block in the theme editor.

1. In your Shopify admin, go to Online Store > Themes.
2. Click Customize on your live theme.
3. In the theme editor's top dropdown, select Products > Default product (or whichever product template you use).
4. In the left sidebar, click Add section.
5. Under the Apps group, click Similar vibe.
6. Drag the section to where you want it on the page. Most stores place it directly below the product description or below the "You might also like" area.
7. Click Save.

Open any product page on your storefront. The Similar Vibe widget should appear with a row of related products. The widget styles itself to match your theme's typography and colour palette.

Adding Nexology Search to your storefront

Nexology Search replaces or augments your theme's built-in search with semantic, multilingual, typo-tolerant search. You enable it as a theme app embed.

1. In your Shopify admin, go to Online Store > Themes.
2. Click Customize on your live theme.
3. In the left sidebar, click the App embeds icon (the puzzle piece near the bottom).
4. Find Nexology Search in the list.
5. Toggle it on.
6. Click Save.

App embeds apply across the whole storefront. You do not need to add Search to individual templates.

To test, open your storefront and type a query into the search bar. You should see results returned by Nexology. Try a deliberately misspelled query, a query in another language, or a descriptive query like "wedding guest dress" to see semantic search in action.

Configuration

Most stores do not need to configure anything. Nexology is designed to work well out of the box.

The Nexology admin offers one optional configuration area:

• Product visibility rules. Hide specific products, collections, or tags from recommendations and search results. Useful for excluding draft products, archived seasons, or items you do not want to surface algorithmically.

Visibility rules live in the Nexology admin inside Shopify. Changes apply within a few minutes.

How to test

A short checklist to confirm everything is working after install.

1. Open the Nexology admin and confirm the catalogue progress bar shows products processed. Aim for at least 50 products processed before you start testing the widget.
2. Visit a product detail page on your storefront. Confirm the Similar Vibe widget renders with related products. The products shown should feel visually similar in aesthetic.
3. Run a search on your storefront. Try a clean keyword, a typo, and a descriptive phrase. Confirm relevant results appear.
4. If you sell across regions, run a search in another language. Confirm relevant results appear from your single catalogue, with no translation step.
5. Visit the analytics dashboard in the Nexology admin. Confirm searches and recommendation impressions are being recorded.

If any of these steps fail, see Troubleshooting below.

Troubleshooting

If your install hits one of these failure modes, the answer is below. Each is also deep-linkable from a support reply.

Data and privacy

A short summary of how Nexology handles your data. The full policy is at /privacy and our terms are at /terms.

• We store your Shopify shop domain, your Shopify access token (encrypted using AWS Key Management Service), and your configuration choices.
• We process your product catalogue (titles, descriptions, images, tags, variants, inventory, collections) to generate vector embeddings used for search and recommendations.
• Shopper interactions on your storefront (search text and product clicks) are recorded as anonymous events. We do not collect shopper names, email addresses, or persistent identifiers, and we do not set cookies on your storefront.
• All product and shopper data is stored in the United Kingdom (AWS London) or the European Economic Area (Qdrant Cloud).
• When you uninstall, your access token is deleted immediately. Your configuration and embeddings are deleted within 48 hours via Shopify's data erasure process.
• Nexology Ltd is registered with the UK Information Commissioner's Office under reference ZC106376.

A data processing agreement is available for merchants at any time from data@nexology.co.uk

Support

Use the address below that best matches your enquiry. We typically respond within one business day.