Troubleshooting

Not signed in / Login not working

Symptom: “Sign in” button appears, or you see a login screen.

Solutions:

  1. Clear session and retry:

    • Go to Profile tab in the sidepanel
    • Click Logout
    • Close the extension
    • Open the extension again and click Sign in
    • You should be redirected to sign in via hilalsoftware.tools
  2. Check your Hilal account:

  3. Clear browser cookies:

    • Go to Chrome Settings → Privacy and security → Clear browsing data
    • Select “Cookies and other site data”
    • Clear data for hilalsoftware.tools
    • Return to the extension and sign in again
  4. Session expired:

    • You may need to log back into hilalsoftware.tools in your browser
    • Then return to the extension and try signing in

Session expired in the extension

Symptom: You were logged in, but now see an empty sidepanel or “Sign in again” message.

Cause: Your Hilal session cookie expired (usually after a few days of inactivity).

Solution:

  1. Click Login in the extension (or go to Profile tab and scroll down)
  2. You’ll be taken to hilalsoftware.tools to re-authenticate
  3. Once signed in on hilalsoftware.tools, return to the extension and you’ll be automatically signed in

Product analytics widget not appearing

Symptom: You’re on an Amazon product page, but the Product Analysis tab doesn’t show or the widget is blank.

Possible causes & solutions:

1. Wrong page type

The widget only injects on Amazon product detail pages (e.g., amazon.com/dp/ASIN).

  • Check: The URL should contain /dp/ followed by an ASIN
  • Try: Search for a product on Amazon, click on a result, and check if the widget appears

2. Shadow DOM or page structure

Some older Amazon page layouts or regional versions may have different DOM structures.

  • Workaround: Try a different Amazon marketplace (e.g., amazon.co.uk instead of amazon.com)
  • Contact support: If the issue persists on multiple products, report it

3. Not signed in

The widget requires an active Hilal session.

  • Check: Look at the Profile tab — are you signed in?
  • Fix: Follow the Not signed in section above

4. Marketplace not supported

The widget is designed for the 20 supported Amazon marketplaces. If you’re on a regional site not in the list, it may not work.

  • Supported regions: com, co.uk, de, fr, it, es, ca, com.au, co.jp, in, ae, nl, se, pl, com.mx, com.br, sg, eg, sa, com.tr
  • Try: Switch to a supported marketplace

Knowledge Base upload failed

Symptom: Error message when uploading a file or website.

Solutions:

  1. File too large:

    • Check file size limits in your plan (see Knowledge base for details)
    • Try splitting large PDFs or documents into smaller files
  2. Unsupported format:

    • Supported: PDF, DOCX, DOC, TXT, and common document formats
    • Try converting your file to PDF or TXT
  3. Website indexing timeout:

    • If adding a website times out, try a smaller section (e.g., specific /docs/ folder instead of entire site)
    • Check that the website is publicly accessible
  4. Storage quota exceeded:

    • Check your plan’s knowledge base storage limit
    • Delete old or unused documents to free space
    • Upgrade your plan for more storage

Keyboard shortcuts not working

Symptom: Pressing your configured shortcut doesn’t open the extension or Ask tab.

Solutions:

  1. Check shortcut assignment:

    • Go to Options → Keyboard shortcuts
    • Verify your shortcut is saved
  2. Conflict with other extensions:

    • Another extension may be using the same keyboard shortcut
    • Try a different shortcut combination (e.g., Ctrl+Shift+K instead of Ctrl+Shift+A)
  3. Browser-level conflict:

    • Some shortcuts are reserved by Chrome (e.g., Ctrl+L opens the address bar)
    • Try a different modifier combination
  4. Extension disabled:

    • Check that the extension is enabled in Chrome Settings → Extensions

How to report a problem

If you encounter an issue not covered above:

  1. Gather details:

    • Note the exact error message (if any)
    • Record steps to reproduce the problem
    • Note your browser version (Chrome menu → Help → About Google Chrome)
    • Note the Amazon marketplace you were on
  2. Contact Hilal support:

  3. Check your account:

    • Verify your plan includes the feature you’re trying to use
    • Some features may be limited by your subscription

Still need help?