Suggested Links

Show up to four promotional links inside the search bar popup so shoppers can jump straight to a sale, a new collection, or a curated landing page.

Overview

Suggested Links appear as clickable chips inside the search bar popup, under a "See also" heading. They are not search queries — clicking a chip navigates the shopper directly to the URL you configure.

Use them to highlight:

• Active sales and seasonal campaigns
• New collections or featured categories
• Specific landing pages you're driving traffic to (gift guides, lookbooks, etc.)
• Anything you want one click away from the search bar

Up to 4 links per application, with optional per-language titles so the same campaign chip can read "Summer Sale" in English and "Καλοκαιρινές προσφορές" in Greek.

Setting up Suggested Links

1. Go to Applications > your app > Settings.
2. Scroll to the Suggested Links section.
3. Toggle Suggested Links on.
4. Click Add Link and provide:
   • URL — the destination, starting with https:// (e.g. https://mystore.com/collections/summer-sale).
   • Title (EN) — the chip label shown to English-speaking visitors. Required.
5. Add up to 4 links total.
6. Reorder links by drag-and-drop — the order determines the chip order in the popup.
7. Click Save.

Translating titles into more languages

Each link has one shared URL but can carry a different title per language. English is the canonical fallback — when a visitor's language doesn't have a translation, the widget shows the English title instead.

To add translations for a link:

1. On the Suggested Links row, click the Translate button.
2. The modal opens with the current English title pre-filled.
3. Fill in the title in every additional language you support (e.g. Greek).
4. Leave any language blank to fall back to the English title at display time.
5. Click Save translation, then Save on the main Suggested Links panel.

The widget picks the active language at render time and chooses the matching title automatically. There's no extra setup on the integration side — the URL stays the same; only the chip label changes per locale.

URL requirements

Every URL must use HTTPS and be an absolute URL — relative paths are rejected:

✅  https://mystore.com/collections/summer-sale
✅  https://mystore.com/pages/black-friday
✅  https://mystore.com/collections/new-arrivals?utm_source=searchx
❌  http://mystore.com/sale              (HTTP not allowed)
❌  /collections/sale                     (must be absolute)
❌  www.mystore.com/sale                  (missing https://)

Tracking parameters in the URL (?utm_source=…, ?ref=…, etc.) are passed through unchanged, so you can attribute clicks the same way you do for any other marketing link.

Use cases

Seasonal promotions

Direct visitors to time-sensitive campaigns:

• "Summer Sale" → https://mystore.com/collections/summer-sale
• "Black Friday Deals" → https://mystore.com/pages/black-friday
• "Holiday Gift Guide" → https://mystore.com/collections/holiday-gifts

New arrivals

Showcase recently added inventory:

• "New Arrivals" → https://mystore.com/collections/new
• "Just Landed" → https://mystore.com/collections/latest

Category spotlights

Highlight specific product categories or curated collections:

• "Outdoor Furniture" → https://mystore.com/collections/outdoor
• "Kids Essentials" → https://mystore.com/collections/kids

Special offers

Promote ongoing campaigns or exclusive deals:

• "Clearance Items" → https://mystore.com/collections/clearance
• "Bundle & Save" → https://mystore.com/pages/bundles

Display behaviour

• Location — chips render inside the search bar popup, above the Featured Products section.
• Visibility — only shown when the feature is enabled and at least one link is configured.
• Language — each chip shows the title for the active language, falling back to English when a translation is missing.
• Order — chips appear in the order you set via drag-and-drop.
• Maximum — up to 4 links per application.

SDK integration

Suggested Links are fetched automatically when the widget initialises. No client-side configuration is required — once you save them in the dashboard, they appear in the popup on the next page load.

If you want to override the dashboard-managed list (for example in a preview environment), you can pass suggestedLinks inline as a setting. See SDK Reference — Search bar popup settings for the supported shapes.

Managing via the API

You can also manage Suggested Links programmatically through the Applications API. Each link has a single url and a title object keyed by locale.

Enable and configure

curl -X PUT "https://admin.searchxengine.ai/api/v2/applications/YOUR_APP_ID" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "suggested_links_enabled": true,
    "suggested_links": [
      {
        "url": "https://mystore.com/collections/summer-sale",
        "title": {
          "en": "Summer Sale",
          "el": "Καλοκαιρινές προσφορές"
        }
      },
      {
        "url": "https://mystore.com/collections/new",
        "title": {
          "en": "New Arrivals"
        }
      }
    ]
  }'

• title.en is required — it's the canonical fallback when other locales are missing.
• Any other locale key (el, de, …) is optional. The widget renders the matching one when the visitor is browsing in that language.

Disable Suggested Links

curl -X PUT "https://admin.searchxengine.ai/api/v2/applications/YOUR_APP_ID" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "suggested_links_enabled": false
  }'

See Applications API for the full reference.

Difference from Suggested Search Terms

SearchX offers two similar but distinct features:

When to use Suggested Links:

• Promoting specific landing pages, collections, or campaigns.
• Directing visitors to curated shopping experiences.
• Highlighting sales, offers, or seasonal content.

When to use Suggested Search Terms:

• Guiding visitors to popular product searches.
• Showcasing trending categories or product types.
• Helping visitors discover common search queries.

Best practices

Keep titles short

Chips read best at 2–4 words. Long titles get truncated:

• ✅ "Summer Sale", "New Arrivals", "Black Friday"
• ❌ "Check out our amazing summer sale with discounts up to 50%"

Translate the campaign chips you ship to multi-language stores

If your storefront has both English and Greek visitors, leaving the Greek title blank means Greek visitors see the English chip. That's a soft failure (they'll still understand a name like "Summer Sale"), but a translated chip ("Καλοκαιρινές προσφορές") performs noticeably better in click-through.

Rotate seasonally

Suggested Links shine when they reflect what's currently happening on the store:

• Refresh before major shopping seasons (holidays, back-to-school, etc.).
• Remove expired promotions promptly — a stale "Summer Sale" chip in October hurts trust.

Test the destination

Always verify before saving:

• The URL opens the right page.
• The landing page is live and accessible.
• The URL uses https:// (required).

Prioritise high-value pages

The first chip gets the most clicks — put your most important promotion there.

Related

• Product Showcase — Featured products that appear in the search bar popup alongside Suggested Links.
• SDK Reference — Full configuration reference.
• Applications API — Manage applications programmatically.
• Localization — Customise widget text and language detection.