> ## Documentation Index
> Fetch the complete documentation index at: https://docs.highailabs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Safari Shopping Assistant

> Get strain intelligence while browsing dispensary menus with the High IQ Safari extension.

## Overview

The Safari Shopping Assistant is a browser extension that brings High IQ strain intelligence directly into your dispensary shopping experience. When you visit a supported dispensary website in Safari, the extension automatically detects products on the page, matches them against the High IQ strain database, and shows personalized badges right next to each product -- so you can see your favorites, running-low alerts, and matched strains without leaving the dispensary menu.

No app switching. No copy-pasting strain names. The intelligence you need appears inline, exactly where you are already shopping.

<Snippet file="ios-only-note.mdx" />

<Warning>
  The Safari Shopping Assistant is currently in **development** and available only to beta testers behind a feature flag. It is not yet available in the production App Store release.
</Warning>

## Key Features

<CardGroup cols={2}>
  <Card title="Automatic Detection" icon="radar">
    The extension recognizes when you are on a supported dispensary platform -- Dutchie, Jane, Weedmaps, Leafly, or any custom-saved dispensary -- and activates automatically.
  </Card>

  <Card title="Inline Badges" icon="tags">
    Color-coded badges appear next to matched products directly on the dispensary page. Green for favorites in stock, yellow for running low, blue for matched strains.
  </Card>

  <Card title="Floating Summary" icon="circle-info">
    A floating action button shows a quick match summary: how many products were matched, how many favorites are available, and any running-low alerts.
  </Card>

  <Card title="Overlay Panel" icon="table-columns">
    Tap the floating button to open a tabbed overlay with your full match results -- All products, Matched strains, Favorites in stock, and Alerts for low-stash items.
  </Card>

  <Card title="Deep Links" icon="arrow-up-right-from-square">
    Tap any matched product in the overlay to open its full strain profile in the High IQ app, complete with terpene data, effects, and your personal notes.
  </Card>

  <Card title="SPA Support" icon="rotate">
    The extension watches for page changes and lazy-loaded content on single-page apps, so badges update as you navigate between categories without reloading.
  </Card>
</CardGroup>

## How to Enable the Extension

<Steps>
  <Step title="Update High IQ">
    Make sure you have the latest version of High IQ installed. The Safari extension ships inside the app -- there is no separate download.
  </Step>

  <Step title="Open Safari Settings">
    On your iPhone, go to **Settings > Apps > Safari > Extensions**.
  </Step>

  <Step title="Enable High IQ Shopping">
    Find **High IQ Shopping** in the extensions list and toggle it on. Grant permission for the websites you want it to run on, or select "All Websites" for full coverage.
  </Step>

  <Step title="Browse a Dispensary">
    Open Safari and visit any supported dispensary website. The extension activates automatically when it detects a dispensary menu.
  </Step>
</Steps>

<Tip>
  If you do not see High IQ Shopping in the Safari extensions list, make sure the app is updated to the latest version and restart Safari.
</Tip>

## How It Works When You Visit a Dispensary

Once the extension is enabled, this is what happens when you navigate to a dispensary website:

<Steps>
  <Step title="Website Detection">
    The extension checks the URL against known dispensary platforms (Dutchie, Jane, Weedmaps, Leafly) and your custom-saved dispensary domains. If it recognizes the site, it activates.
  </Step>

  <Step title="Product Extraction">
    The extension reads the page content to find product listings -- strain names, prices, and categories. It handles dynamically loaded content and menu navigation automatically.
  </Step>

  <Step title="Batch Matching">
    Extracted product names are sent to the High IQ API in a single batch request. The API runs three-tier matching (exact name, URL slug, and fuzzy trigram similarity) against 16,000+ strains in the database.
  </Step>

  <Step title="Personalization">
    Your favorites, stash levels, and disliked strains are factored in. The extension knows which strains you love, which you are running low on, and which you want to avoid.
  </Step>

  <Step title="Badges Appear">
    Color-coded badges are injected next to matched products on the page. A floating action button appears in the corner with a summary of your results.
  </Step>
</Steps>

## Understanding the Badges

Badges appear inline next to product names on the dispensary menu page. Each color indicates a different type of match.

| Badge Color | Icon       | Meaning                                                                     |
| ----------- | ---------- | --------------------------------------------------------------------------- |
| **Green**   | Heart      | This is one of your favorited strains -- it is in stock at this dispensary  |
| **Yellow**  | Arrow down | You have this strain in your stash and it is running low -- time to restock |
| **Blue**    | Check      | This product was matched to a strain in the High IQ database                |

<Note>
  Products that are not matched to any strain in the database do not receive a badge. This can happen with house blends, brand-specific product names, or very new strains that have not been cataloged yet.
</Note>

## The Overlay Panel

Tapping the floating action button opens a full overlay panel with four tabs:

| Tab           | What It Shows                                                                  |
| ------------- | ------------------------------------------------------------------------------ |
| **All**       | Every product detected on the page, matched and unmatched                      |
| **Matched**   | Only products that were successfully identified in the strain database         |
| **Favorites** | Your favorited strains that are currently available at this dispensary         |
| **Alerts**    | Strains you are running low on that are in stock -- your restock opportunities |

Each product in the overlay shows the matched strain name, confidence level, and any personalization tags. Tapping a product opens its full strain profile in the High IQ app via deep link.

## Personalization

The Shopping Assistant uses your High IQ data to make the experience personal:

* **Favorites:** Strains you have favorited are highlighted with green badges and appear in the Favorites tab
* **Stash levels:** Strains where your stash is running low get yellow badges and appear in the Alerts tab
* **Dislikes:** Strains you have marked as disliked are dimmed or hidden from recommendations

<Tip>
  Keep your favorites and stash data up to date in the High IQ app. The more accurate your data, the more useful the Shopping Assistant badges become.
</Tip>

## Supported Dispensary Platforms

The extension includes built-in support for the following platforms:

| Platform                | Coverage                                                    |
| ----------------------- | ----------------------------------------------------------- |
| **Dutchie**             | Full support with dedicated adapter                         |
| **Jane / iHeartJane**   | Supported                                                   |
| **Weedmaps**            | Supported                                                   |
| **Leafly**              | Supported                                                   |
| **Custom dispensaries** | Any dispensary you have saved in High IQ with a website URL |

<Note>
  Platform support is being expanded. If the extension does not activate on your dispensary's website, you can add the dispensary manually in the High IQ app with its website URL. The extension will then recognize it on future visits.
</Note>

## Privacy and Data

* **Page content stays on your device.** The extension reads the dispensary page locally to find product names. It does not send the full page content to any server.
* **Only product names are sent to the API.** The batch matching request contains only the extracted product names -- no browsing history, page URLs, or personal information.
* **Your favorites and stash data are read locally.** Personalization data is shared between the app and the extension using secure on-device App Groups storage. It is not re-fetched from the network on every page load.
* **Matched data is cached locally for 24 hours.** Repeat visits to the same dispensary use cached results, reducing network requests.

## Troubleshooting

<AccordionGroup>
  <Accordion title="The extension does not appear in Safari Settings">
    Make sure you have the latest version of High IQ installed. The Safari extension is bundled inside the app and registers with iOS automatically. If it still does not appear, try restarting your device.
  </Accordion>

  <Accordion title="No badges appear on the dispensary page">
    Check that the extension is enabled in **Settings > Apps > Safari > Extensions > High IQ Shopping**. Also verify that you have granted it permission to run on the current website. If the site uses an unusual menu layout, the extension may not be able to detect products -- try another dispensary to confirm the extension is working.
  </Accordion>

  <Accordion title="Products are detected but none are matched">
    This can happen if the dispensary uses house names or brand-specific product names that differ from standard strain names. The matching system handles common variations, but heavily customized names may not resolve. You can help by using the Shopping Agent in the app to scan the full menu -- discoveries from that flow are queued for the strain research pipeline.
  </Accordion>

  <Accordion title="The extension stopped working after an app update">
    Safari extensions are re-registered when the host app updates. Go to **Settings > Apps > Safari > Extensions** and confirm High IQ Shopping is still enabled. You may need to re-grant website permissions after a major update.
  </Accordion>

  <Accordion title="Badges are not updating when I navigate between menu pages">
    The extension monitors for page changes, but some dispensary sites use unconventional navigation that may not trigger detection. Try refreshing the page manually. If the issue persists on a specific site, it may require a dedicated platform adapter -- contact support so we can investigate.
  </Accordion>

  <Accordion title="The extension seems slow">
    The first visit to a dispensary requires a network request to match products against the database. This typically takes a few seconds depending on the number of products on the page. Subsequent visits within 24 hours use cached data and should be near-instant.
  </Accordion>
</AccordionGroup>

## Tips for Best Results

<Tip>
  **Save your dispensaries in High IQ.** The extension recognizes dispensaries you have saved in the app. Adding your regular dispensaries with their website URLs ensures the extension activates every time you visit.
</Tip>

<Tip>
  **Grant "All Websites" permission** if you shop at multiple dispensaries. This saves you from having to approve each site individually. The extension only activates on recognized dispensary domains -- it does not run on unrelated websites.
</Tip>

<Tip>
  **Use alongside the Shopping Agent.** The Safari extension gives you quick inline badges while browsing. For deeper analysis with AI recommendations and new strain discovery, use the full Shopping Agent from the dispensary detail page in the app.
</Tip>

## Related Features

* [Shopping Agent](/help/features/shopping-agent) -- Full AI-powered menu scanning with recommendations
* [Dispensary Tracking](/help/features/dispensaries) -- Manage your dispensary list and add website URLs
* [Stash Management](/help/features/stash-management/overview) -- Keep stash data current for accurate running-low alerts
* [Strain Discovery](/help/features/strain-discovery/searching) -- Search and explore the 16,000+ strain database

<Snippet file="contact-support.mdx" />

<Snippet file="ios-only-note.mdx" />
