1. WordPress Nonces (Security Tokens)

WordPress uses time-sensitive security tokens called “nonces” that expire every 24 hours. When these get cached by your browser, they become invalid but your browser keeps sending the old tokens, causing authentication to fail.

2. Multiple Authentication Cookies

WordPress uses several authentication cookies (wordpress_logged_in, wordpress_sec, etc.) that must stay synchronized. Browser caching can cause these to become mismatched.

3. React/JavaScript State Caching

Modern WordPress (Gutenberg editor) uses React, which can cache authentication state in JavaScript memory. This cached state may conflict with the extension’s auth sync.

4. AJAX Request Conflicts

WordPress admin heavily uses AJAX requests with authentication tokens. Cached tokens in these requests can cause silent failures.

Issue: WordPress 4-Field Auto-Fill Not Working

Symptoms:

• Only Alt Text field is filled, not Title/Caption/Description
• No error messages shown
• Works after clearing cache

Solution:

1. Clear ALL browser data for your WordPress site:
   • Go to Chrome Settings → Privacy → Clear browsing data
   • Select “Cookies and other site data” AND “Cached images and files”
   • Time range: “All time”
   • Click “Clear data”
2. Sign out completely:
   • Sign out of WordPress admin
   • Sign out of QuickAltText extension
   • Close all WordPress tabs
3. Sign back in fresh:
   • Open WordPress admin in a new tab
   • Sign into WordPress first
   • Then sign into QuickAltText extension
   • Try the 4-field auto-fill again

Issue: “Not Signed In” Despite Being Logged In

Symptoms:

• Extension shows “Not signed in” on WordPress pages
• You’re clearly logged into the extension
• Other sites work fine

Solution:

1. Check browser console for errors:
   Right-click → Inspect → Console tab
   Look for red error messages about “auth” or “session”
2. Force a fresh auth sync:
   • Open the extension popup
   • Sign out
   • Clear cookies for quickalttext.com
   • Sign in again
   • Wait 10 seconds before using

Issue: Auto-Apply Fails Silently

Symptoms:

• Right-click → Auto-Apply does nothing
• No error messages
• Manual overlay mode works fine

Solution:

1. Verify you’re on a supported WordPress page:
   URL should contain: /wp-admin/
   Must be in Media Library or Post Editor
2. Check if fields are visible:
   • WordPress media modal must be open
   • All 4 fields must be visible on screen
   • Try clicking the image first to open details panel
3. Enable Expert/Agency tier features:
   • 4-field auto-fill requires Expert or Agency subscription
   • Free/Pro tiers only fill Alt Text field

Why You May Experience Random Logouts

This is a Chrome browser behavior, not a QuickAltText bug. Chrome clears extension memory storage in these situations:

• Browser restart – All session storage is wiped
• System memory pressure – When RAM usage exceeds 75%
• Tab inactivity – Tabs inactive for 30+ minutes
• Chrome updates – Automatic updates clear session data
• System crashes or forced restarts

🆕 Solution: “Keep Me Signed In” Feature (v2.2.0)

QuickAltText now offers an optional “Keep Me Signed In” toggle that prevents random logouts by using persistent storage instead of memory storage.

How to Enable:

1. Click the QuickAltText extension icon
2. Sign in to your account
3. Scroll to “Security Settings” section
4. Toggle “Keep me signed in” to ON
5. Read and acknowledge the security warning

Solution: Optimize Chrome Settings

1. Check Memory Saver Setting:
   chrome://settings/performance
   → If “Memory Saver” is ON, turn it OFF
2. Monitor System RAM Usage:
   • Keep browser tabs under 20-30 open tabs
   • Close memory-heavy applications
   • Restart Chrome if it’s using >2GB RAM
3. Use “Continue where you left off”:
   chrome://settings/onStartup
   → Select “Continue where you left off”

🔍 Technical Details

QuickAltText uses Chrome’s secure session storage for maximum security (patent-pending auth system). This memory-only storage prevents token theft but is cleared when Chrome needs memory. This is a tradeoff between security and persistence that affects all Chrome extensions.

Chrome

1. Settings → Privacy and security → Clear browsing data
2. OR press Ctrl+Shift+Delete (Windows) / Cmd+Shift+Delete (Mac)
3. Select “Cookies” and “Cached images and files”
4. Choose “All time” for time range

Edge

1. Settings → Privacy, search, and services → Clear browsing data
2. OR press Ctrl+Shift+Delete
3. Select same options as Chrome

Brave

1. Settings → Privacy and security → Clear browsing data
2. Process identical to Chrome

Firefox

1. Settings → Privacy & Security → Cookies and Site Data → Clear Data
2. OR press Ctrl+Shift+Delete (Windows) / Cmd+Shift+Delete (Mac)

Note: Some highly customized WordPress sites might not be detected. If auto-apply isn’t working on your WordPress site, please contact support.

1. Collect diagnostic information:

• Your browser and version
• WordPress version
• Any error messages from browser console
• Screenshot of the issue

2. Contact our support team:

• Email: admin@quickalttext.com
• Include the diagnostic information above
• We typically respond within 24 hours

Pro Tip: Prevent Future Issues

• Clear cache weekly if you use WordPress daily
• Use incognito/private mode for testing
• Keep Chrome and the extension updated