> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.ubuyfirst.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# SKU Manager: Troubleshooting & FAQ

Table Of Contents

* [Troubleshooting](#0-toc-title)
* [Nothing Showing in the External Panel](#1-toc-title)
* [Filter Not Triggering](#2-toc-title)
* [AI Analysis Takes Too Long](#3-toc-title)
* [API Provider Issues](#4-toc-title)
* [How Do I Recheck After Updating My Prompt?](#5-toc-title)
* [Template Showing Raw Code Instead of Formatted Output](#6-toc-title)
* [Frequently Asked Questions](#7-toc-title)
* [General](#8-toc-title)
* [Working with Product Data](#9-toc-title)
* [AI Columns vs. Display Template](#10-toc-title)
* [External Panel Tips](#11-toc-title)
* [Advanced](#12-toc-title)
* [Still Stuck?](#13-toc-title)

Quick answers to common questions and issues.

---
## Troubleshooting
### Nothing Showing in the External Panel

**If you see “No Description”** — This means a filter was NOT triggered for AI analysis. The listing didn’t match your filter conditions.

**If the panel is completely blank:**

1. Go to **View > Panels > External Data Panel** to make sure it’s visible

2. Check that **SKU Manager** is enabled in the main menu

3. Verify your filter is **Enabled** (checkbox checked)

4. Confirm the script is running (green button in External Data panel)
---
### Filter Not Triggering

Not sure if your filter is set up correctly? Test it visually:

1. Load some search results first

2. Go to **Home > Filters** and edit your filter

3. Change the **Action** from “Apply AI Prompt” to **“Format Rows”**

4. Under Format Style, click **Back Color** and pick a highlight color

5. Click **OK** to save

6. Check your results — highlighted rows are what the AI would analyze

Once confirmed, change the action back to “Apply AI Prompt.”

---
### AI Analysis Takes Too Long

AI analysis typically takes **5-15 seconds** after the listing loads. If it’s consistently slow:

**Quick fix:** Enable **“Show results first, do not wait for AI”** in the External Data panel. This shows listings immediately while AI processes in the background.

**For ongoing slowness:**

* Consider what’s most important in your prompt
* Image analysis takes the most time — you can add conditional logic to only analyze images when certain criteria are met
* Submit feedback traces to your AI project and ask: _“This is taking longer than expected. Can we reorganize for speed and optimization based on what’s most critical?”_

---
### API Provider Issues

**“Rate limited” or throttling errors:**

* New API accounts are sometimes throttled initially
* Check your email for verification requests from your provider
* Usually resolves within 24-48 hours

**Billing/authentication errors:**

* Verify billing is active on your API account
* Check that your API key is complete (no missing characters)
* Monitor usage in your provider’s dashboard after a few days

---
### How Do I Recheck After Updating My Prompt?

If you still have listings in your results panel:

1. Update and save your prompt (and/or template)

2. When you edit anything, previous AI results for that profile are cleared

3. Simply **click on a listing** — it will automatically rerun the analysis

**To update AI Columns specifically:** Right-click on the column header in results view → **“Update LLM Columns”**

---
### Template Showing Raw Code Instead of Formatted Output

* Check that your Display Template contains valid HTML
* Verify the preview in the AI Display Template tab shows formatted content
* Make sure the template is selected in your filter’s profile settings

---
## Frequently Asked Questions
### General

**Can the AI do calculations and math?** Yes. You can include pricing logic, profit calculations, quantity math, and more in your prompt.

**How much does it cost to run?** Usually **cents per transaction**. Check your API provider’s billing dashboard after a couple of days to see actual usage. Gemini tends to be cheaper than OpenAI for most use cases.

**What model should I use?**

| Provider | Recommended Model | Notes |
| --- | --- | --- |
| Gemini | gemini-2.5-flash | Fast and cost-effective — start here |
| OpenAI | gpt-4o or gpt-4o-mini | Good for complex analysis |

**How do I format the model name?** In SKU Manager, enter it as: `provider/model-name`

* Gemini: `gemini/gemini-2.5-flash`
* OpenAI: `openai/gpt-4o`

---
### Working with Product Data

**How many products/variants can I include in my prompt?**

* **Dozens to hundreds** works well
* **Thousands** is too many — it slows processing and increases costs
* Best for variants: If searching “iPhone 15,” include all variants (Pro, Pro Max, storage sizes, carriers) with their criteria

**Can I use my Excel price sheet?** Yes! When creating your prompt with Claude/ChatGPT:

1. Upload your spreadsheet file

2. Explain what each column contains

3. The AI will build logic to match listings against your data

This works great for:

* Different models with different max prices
* Variants you buy vs. don’t buy
* Condition-based pricing

**What about larger databases?** For extensive price lists, ask us about **Internal Endpoint** (beta) — this uses Python code with your CSV data for local processing. Contact support for details.

---
### AI Columns vs. Display Template

**What’s the difference?**

| Feature | Display Template | AI Columns |
| --- | --- | --- |
| Where it shows | External Panel | Results grid |
| Best for | Detailed analysis, explanations | Quick Yes/No decisions |
| Format | Full HTML with formatting | Simple values |

**Example use case:** Your search is “iPhone 15” but you only buy iPhone 15 Pro. Create an AI Column called “Buying?” that outputs Yes/No. Then create a filter that removes rows where “Buying?” = No.

**Can I use AI Columns to trigger additional analysis?** Yes — you can chain filters. Run a simple first analysis with AI Columns, then trigger a deeper prompt only for listings that meet certain criteria. This saves on API costs and speeds up processing.

---
### External Panel Tips

**How do I resize the text in the External Panel?**

* Single-click in the External Panel
* Hold **Ctrl** and use **mouse wheel** up/down to zoom

**How do I export or share the output?**

* **View source:** Right-click in panel → **“View Page Source”** → opens in Notepad
* **Save as PDF:** Right-click → **“Print”** → Save as PDF
* Note: Images won’t be included in the PDF

**For proper issue reporting:** Use the Feedback/Trace system instead — it captures everything including images.

---
### Advanced

**Can I use both AI and Internal Endpoint?** Currently no — you must choose one or the other per filter. We’re planning to connect these in a future update. Contact us if you have specific use cases.

**Can I connect other business data for analysis?**

* **In the prompt:** Include dozens/hundreds of items directly
* **Via Internal Endpoint:** Connect CSV files for Python-based processing (beta)
* Contact us to discuss your specific needs

---
## Still Stuck?1. **Check the basics:** Filter enabled? Script running (green)? API billing active?

2. **Use Feedback Traces:** When something’s wrong, submit feedback in SKU Manager to capture diagnostic files

3. **Contact us:** [Live Support](https://ubuyfirst.com/) or su*****@*******st.com
---

See also: [Quick Start Guide](https://claude.ai/chat/ee92e4d4-6210-417b-917b-d9a11d0f392f#) | [Full Setup Guide](https://claude.ai/chat/ee92e4d4-6210-417b-917b-d9a11d0f392f#) | [Using Feedback & Traces](https://claude.ai/chat/ee92e4d4-6210-417b-917b-d9a11d0f392f#)