Settings

The Settings window allows you to configure store connections, AI providers, confirmation dialogs, and synchronization options.

Opening Settings

  • Menu: Tools > Settings
  • Toolbar: Click the gear icon

Settings Tabs

The Settings window is organized into four tabs:

  1. Stores - Manage Shopify store connections
  2. AI Settings - Configure AI providers for content generation
  3. General - Confirmation dialogs and application preferences
  4. Sync - Product and inventory synchronization options

Stores Tab

Manage your connected Shopify stores from this tab.

Store List

View all connected stores with:

  • Store display name and domain
  • Active store indicator
  • Client ID
  • API scopes granted

Store Actions

Button Description
Add Store Connect a new Shopify store
Edit Modify selected store's connection settings
Refresh Scopes Re-fetch API scopes from Shopify
Delete Remove store from the application

See Connecting to Shopify for detailed setup instructions.

AI Settings Tab

Configure AI providers for description and title generation.

Provider Tabs

The AI Settings tab contains sub-tabs for each supported provider:

  • Google Gemini
  • Anthropic Claude
  • OpenAI ChatGPT

Provider Configuration

Each provider requires:

Setting Description
API Key Your API key from the provider (stored encrypted)
Model Select which AI model to use
Temperature Creativity level (0 = focused, 1 = creative)
Max Tokens Maximum response length

Getting API Keys

Provider Where to Get Key
Google Gemini Google AI Studio
Anthropic Claude Anthropic Console
OpenAI OpenAI Platform
Provider Model Best For
Gemini gemini-2.0-flash Fast, cost-effective generation
Claude claude-sonnet-4 High-quality writing
OpenAI gpt-4o-mini Balance of speed and quality

AI Prompt Presets

Access Tools > AI Prompt Presets to create and manage custom prompt templates for titles and descriptions. See AI Prompt Presets for details.

General Tab

Confirmation Dialogs

Control which operations show confirmation prompts:

Setting Description
Bulk price changes Confirm before applying price changes
Bulk inventory changes Confirm before adjusting inventory
Bulk description changes Confirm before updating descriptions
Bulk field changes Confirm before changing tags/status/vendor
Bulk SEO changes Confirm before updating SEO fields
Bulk AI description generation Confirm before AI generates content
Delete media Confirm before deleting product images/videos
Sync operations Confirm before syncing to Shopify

Each confirmation dialog includes a "Don't ask again" checkbox. Once checked, that specific confirmation is suppressed.

Reset Confirmations

Click Reset All to Default to re-enable all confirmation dialogs that were previously dismissed.

Sync Tab

Configure how ProductManager synchronizes data with Shopify.

Product Sync Mode

Choose when products are automatically loaded from Shopify:

Mode Behavior
On Startup (All Stores) Sync all connected stores when app opens
On Store Switch Sync when you switch between stores
Manual Only Only sync when you click the Sync button

Sales Sync Mode

Configure when sales data is synchronized for reports:

Mode Behavior
On Startup (All Stores) Sync sales when app opens
On Store Switch Sync sales when switching stores
On Reports Open Sync when opening the Reports window (default)
Manual Only Only sync via Tools > Sales Data Sync

Product Loading Strategy

Choose how products are loaded from Shopify during sync:

Strategy Description Best For
Auto-detect Automatically selects based on store size Most users (recommended)
Standard API Paginated loading, page by page Small stores (<8,000 data objects)
Bulk Operations Single background job with JSONL download Large stores with many variants

Auto-detection Threshold

When using Auto-detect, ProductManager switches to Bulk Operations when your store exceeds a threshold of total data objects (products + variants + images + metafields).

  • Default threshold: 8,000 objects
  • Adjustable: Use the slider to set between 2,000 and 20,000

Inventory Loading Strategy

Similar options for loading inventory data:

Strategy Description Best For
Auto-detect Automatically selects based on variant count Most users (recommended)
Standard API Per-location paginated loading Stores with <5,000 variants
Bulk Operations Background job for all inventory Stores with 5,000+ variants

Inventory Threshold

  • Default threshold: 5,000 variants
  • Adjustable: Use the slider to set between 1,000 and 20,000

When to Use Bulk Operations

Bulk Operations are beneficial when:

  • Your store has many variants (5,000+)
  • Standard sync takes more than 60 seconds
  • You experience API rate limiting during sync

The tradeoff is a ~5-8 second overhead for the bulk job to start, but much faster overall for large catalogs.

Saving Settings

Click Save to apply all changes. Click Cancel to close without saving.

Most settings take effect immediately. Some may require restarting the application.

Settings Storage

Settings are stored in:

%AppData%\HFProductManager\settings.json

Backup Your Settings

To backup settings:

  1. Close ProductManager
  2. Copy settings.json to a safe location
  3. Restore by copying back

Per-Store Data

Some data is stored separately per store:

  • Product cache
  • Session state (filters, sort, selection)
  • Sync history
  • Window positions

These are stored in:

%LocalAppData%\HFProductManager\

Troubleshooting

"Settings not saving"

  • Ensure you click Save before closing
  • Check write permissions to %AppData%\HFProductManager
  • Try running ProductManager as administrator once

"API key not working"

  • Check key is entered correctly (no extra spaces)
  • Verify key is active in provider's dashboard
  • Check API quota/billing status

"Store connection failing"

  • Verify Client ID and Secret are correct
  • Ensure the Shopify app is installed (not just created)
  • Check required API scopes are enabled

"Sync taking too long"

  • Switch to Bulk Operations strategy for large stores
  • Lower the auto-detection threshold
  • Consider syncing during off-peak hours

See Also