AI Product Tools Documentation Logo
AI Product ToolsDocumentation
Core Features

Settings Configuration

Complete guide to configuring AI Product Tools settings including API providers, prompts, and generation preferences

The Settings page is your control center for configuring AI Product Tools. It's organized into intuitive tabs that group related options, making it easy to find and adjust the settings you need.

Settings Navigation

The settings page features a sidebar navigation with the following sections:

API Settings

Configure AI providers and API keys

Standard Bulk Generator

Settings for the Standard mode

Advanced Bulk Generator

Settings for the Advanced mode

Content Settings

General content generation options

Access Settings

From Dashboard:

  • Click the Settings tab in the header
  • Navigate to AI Product ToolsSettings

Direct Access:

  • Use the gear icons on generation mode cards
  • Access specific setting sections directly

API Settings

AI Provider Selection

Choose between two leading AI providers:

OpenAI Configuration

Supported Models:

  • o1-preview: Latest reasoning model
  • GPT-4o: Advanced multimodal model
  • GPT-4.1: Enhanced language model
  • GPT-4o-mini: Fast and cost-effective

API Key Setup:

  1. Enter your OpenAI API key (starts with sk-)
  2. Click Save Settings
  3. The plugin will automatically test the connection
  4. Look for the green checkmark confirmation

Model Selection:

  • Choose your preferred model from the dropdown
  • Consider cost vs. quality trade-offs
  • GPT-4o-mini recommended for testing

Google Gemini Configuration

Supported Models:

  • Gemini 1.5 Pro: Advanced language model
  • Gemini 1.5 Flash: Fast and versatile
  • Gemini 1.5 Flash-8B: Optimized for speed

API Key Setup:

  1. Enter your Gemini API key
  2. Save and test the connection
  3. Verify successful authentication

API Key Security

Best Practices:

  • Never share your API keys
  • Store keys securely
  • Regenerate if compromised
  • Monitor usage regularly

Key Validation:

  • Automatic testing upon save
  • Real-time connection status
  • Error reporting for invalid keys

Standard Bulk Generator Settings

Prompt Configuration

System Prompt

The system prompt defines the AI's role and behavior:

Default Template:

You are an expert product description writer for e-commerce. Create compelling, SEO-friendly product descriptions that highlight key features and benefits.

Customization Tips:

  • Define your brand voice
  • Specify target audience
  • Include industry-specific requirements
  • Set tone and style preferences

User Prompt Templates

Short Description Prompt:

  • Template for generating brief product summaries
  • Typically 150 characters or less
  • Focus on key selling points

Full Description Prompt:

  • Template for detailed product descriptions
  • Comprehensive feature coverage
  • Include benefits and use cases

Variables in Standard Mode

Standard mode supports these variables:

General Variables:

  • {max_length}: Maximum character count
  • {max_short_length}: Short description limit
  • {language}: Target language
  • {style}: Writing style preference

Product Variables:

  • {title}: Product name
  • {category}: Product category
  • {price}: Product price
  • {regular_price}: Regular price
  • {sale_price}: Sale price
  • {attributes}: Product attributes

Content Parameters

Language Settings:

  • Choose from 50+ supported languages
  • Affects AI output language
  • Maintains consistency across products

Writing Style Options:

  • Professional
  • Creative
  • Casual
  • Technical
  • Persuasive

Length Controls:

  • Max Length: Full description character limit
  • Max Short Length: Short description limit
  • Flexible Limits: AI respects but may vary slightly

Advanced Bulk Generator Settings

Enhanced Prompt System

Advanced Prompts

More sophisticated prompt templates with additional features:

System Prompt Features:

  • HTML formatting support
  • Custom field integration
  • Variable substitution
  • Brand voice definition

User Prompt Templates:

  • Rich text formatting
  • Dynamic content insertion
  • Conditional logic support
  • Multi-language templates

Custom Variables and Fields

Variable System

Advanced mode supports extensive variable customization:

Built-in Variables:

  • All Standard mode variables
  • Extended product data
  • WooCommerce-specific fields
  • Custom attribute mapping

Custom Variable Creation:

  1. Click Add Custom Variable
  2. Select source field
  3. Define variable name
  4. Map to prompt template

Field Mapping

Connect product data to prompt variables:

Supported Field Types:

  • Custom fields
  • Product attributes
  • Meta fields
  • ACF fields (if installed)
  • Third-party plugin fields

Mapping Process:

  1. Identify available fields
  2. Create variable mappings
  3. Test with sample products
  4. Refine as needed

AI Smart Parameters™

Advanced mode includes automatic optimization:

Automatic Adjustments:

  • Temperature optimization
  • Token limit management
  • Model parameter tuning
  • Quality enhancement

Benefits:

  • Improved content quality
  • Reduced API costs
  • Optimized performance
  • Consistent results

Content Settings

Global Content Options

Model Selection

Choose the AI model for single product generation:

OpenAI Models:

  • Model-specific settings
  • Performance characteristics
  • Cost considerations

Gemini Models:

  • Speed vs. quality options
  • Feature availability
  • Usage recommendations

Generation Preferences

Content Types:

  • Enable/disable short descriptions
  • Enable/disable full descriptions
  • Enable/disable tag generation

Quality Settings:

  • Content length preferences
  • Style consistency options
  • Brand voice alignment

Output Formatting

HTML Support (Advanced Mode)

  • Rich text formatting
  • HTML tag preservation
  • Clean markup generation
  • WordPress compatibility

Plain Text Mode (Standard Mode)

  • Clean text output
  • No HTML formatting
  • Universal compatibility
  • Fast processing

Saving and Testing

Save Process

Automatic Validation:

  1. Click Save Settings
  2. Plugin validates all inputs
  3. Tests API connections
  4. Confirms successful save

Error Handling:

  • Clear error messages
  • Specific problem identification
  • Suggested solutions
  • Retry mechanisms

Testing Configuration

API Connection Test

Automatic Testing:

  • Triggered on save
  • Real API call verification
  • Response time measurement
  • Error detection

Content Generation Test

Test with Sample Product:

  1. Select a test product
  2. Generate sample content
  3. Review output quality
  4. Adjust settings if needed

Settings Backup

Export Settings:

  • Download configuration backup
  • Share settings between sites
  • Restore previous configurations

Import Settings:

  • Upload settings file
  • Merge with existing configuration
  • Validate imported settings

Common Configuration Scenarios

E-commerce Store Setup

Recommended Settings:

  • Professional writing style
  • SEO-optimized prompts
  • Moderate content length
  • Tag generation enabled

Creative Product Descriptions

Recommended Settings:

  • Creative writing style
  • Longer content length
  • Rich formatting enabled
  • Custom variables for uniqueness

Technical Product Catalogs

Recommended Settings:

  • Technical writing style
  • Attribute-heavy prompts
  • Structured formatting
  • Specification integration

Troubleshooting Settings

Common Issues

API Key Problems:

  • Verify key format
  • Check account status
  • Confirm permissions
  • Test with simple request

Prompt Issues:

  • Validate variable syntax
  • Test with sample data
  • Check character limits
  • Review output quality

Performance Problems:

  • Optimize prompt length
  • Adjust generation intervals
  • Monitor API usage
  • Check server resources