> ## Documentation Index
> Fetch the complete documentation index at: https://docs.allgoodhq.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Frequently Asked Questions

## Getting Started

<AccordionGroup>
  <Accordion title="What file formats are supported?">
    CSV files are the primary supported format. Excel files should be converted to CSV before upload.
  </Accordion>

  <Accordion title="How large can my CSV file be?">
    allGood can handle CSV files with thousands of contacts. If you have an extremely large file (50,000+ contacts), consider splitting it into smaller batches for optimal performance.
  </Accordion>

  <Accordion title="Do I need special permissions to use List Upload?">
    You need access to the List Upload feature, which is typically granted by your Marketing Operations team. You'll also need the proper integrations (Marketo, HubSpot) configured.
  </Accordion>
</AccordionGroup>

## Field Mapping & Data Requirements

<AccordionGroup>
  <Accordion title="Which fields are required in my CSV?">
    At minimum, you need:

    * **Email address** (required for all platforms)
    * **First Name** and **Last Name** (highly recommended)
    * **Company** (recommended for B2B scenarios)

    Additional fields like job title, phone, and location improve data quality and enrichment opportunities.
  </Accordion>

  <Accordion title="What if my CSV has different column headers?">
    Mary will automatically map common variations. For example, "First Name", "FirstName", "fname", and "Given Name" will all be recognized as first name fields. You can also specify mappings during the conversation.
  </Accordion>

  <Accordion title="How do I know what fields my marketing automation system expects?">
    Mary will check your system's requirements and let you know which fields are needed. Each platform (Marketo, HubSpot) has different field requirements that are automatically validated.
  </Accordion>

  <Accordion title="What if I have extra columns in my CSV that aren't needed?">
    Extra columns are fine - Mary will identify and map the relevant fields while ignoring unnecessary columns.
  </Accordion>
</AccordionGroup>

## Data Cleaning & Enrichment

<AccordionGroup>
  <Accordion title="How do I know if my data needs enrichment?">
    Mary will analyze your data and suggest enrichment opportunities. Common scenarios include:

    * Missing job titles or company information
    * Incomplete contact details
    * Non-standardized job titles or company names
    * Missing location data
  </Accordion>

  <Accordion title="What enrichment services are available?">
    allGood offers several enrichment capabilities:

    * **Basic Enrichment**: Missing contact information from third-party providers
    * **Job Function Categorization**: Engineering, Product, Data Science, etc.
    * **Job Level Assignment**: CxO, VP, Director, Manager, Individual Contributor
    * **Job Role Mapping**: SOC, DevOps, Security, Platform, etc.
    * **Data Standardization**: Phone numbers, addresses, industry alignment
  </Accordion>

  <Accordion title="Can I control which enrichment steps are applied?">
    Yes, Mary will discuss enrichment options with you and you can choose which steps to apply based on your campaign needs and data quality requirements.
  </Accordion>

  <Accordion title="How accurate is the enrichment data?">
    allGood uses multiple data sources and validation techniques to ensure high accuracy. However, you should always review enriched data before final campaign deployment.
  </Accordion>
</AccordionGroup>

## Platform Integration

<AccordionGroup>
  <Accordion title="How do I choose between Marketo, HubSpot, and Plain modes?">
    This depends on your marketing automation system:

    * **Marketo**: Use when you need program creation, campaign member management, and complex event workflows
    * **HubSpot**: Use for contact list management and simpler lead nurturing campaigns
    * **Plain**: Use for basic CSV processing without platform-specific integration
  </Accordion>

  <Accordion title="What's the difference between Marketo and HubSpot processing?">
    * **Marketo**: Program-centric workflow with program cloning, folder management, and complex campaign member statuses
    * **HubSpot**: List-centric workflow focused on contact list creation and management
    * **Processing complexity**: Marketo supports more complex metadata and program structures
  </Accordion>

  <Accordion title="Can I upload the same list to multiple platforms?">
    Yes, you can process the same CSV for different platforms, but you'll need to run separate uploads for each destination system.
  </Accordion>
</AccordionGroup>

## Campaign & Program Management

<AccordionGroup>
  <Accordion title="How do I specify where my contacts should go in Marketo?">
    You can provide program information in your CSV metadata or specify it during the conversation with Mary. Options include:

    * Creating a new program
    * Adding to an existing program
    * Cloning from a template program
  </Accordion>

  <Accordion title="What are campaign member statuses and how do I set them?">
    Campaign member statuses track contact engagement levels (e.g., "Registered", "Attended", "No Show" for webinars). Mary will ask about the appropriate status for your campaign type and validate against your system configuration.
  </Accordion>

  <Accordion title="How do I create new programs vs. using existing ones?">
    Mary will help you decide based on your campaign goals:

    * **New programs**: For new campaigns or events
    * **Existing programs**: When adding contacts to ongoing campaigns
    * **Template cloning**: For standardized campaign types
  </Accordion>
</AccordionGroup>

## Data Quality & Validation

<AccordionGroup>
  <Accordion title="What happens if my CSV has duplicate contacts?">
    Mary will detect duplicates and ask how you want to handle them - typically by keeping the most complete record or merging information.
  </Accordion>

  <Accordion title="How do I handle contacts that are already in my system?">
    Mary will check for existing contacts and provide options:

    * Update existing contact information
    * Skip duplicates
    * Add to additional campaigns/lists
    * Create new records with updated information
  </Accordion>

  <Accordion title="What if some of my data doesn't meet system requirements?">
    Mary will identify validation issues and suggest corrections:

    * Invalid email formats
    * Missing required fields
    * Data format inconsistencies
    * System-specific validation failures
  </Accordion>
</AccordionGroup>

## Processing & Performance

<AccordionGroup>
  <Accordion title="How long does list processing take?">
    Processing time depends on list size and complexity:

    * Small lists (100-1,000 contacts): 2-5 minutes
    * Medium lists (1,000-10,000 contacts): 5-15 minutes
    * Large lists (10,000+ contacts): 15-30 minutes
  </Accordion>

  <Accordion title="Can I process multiple lists simultaneously?">
    It's recommended to process one list at a time to ensure proper attention to each upload and avoid system overload.
  </Accordion>

  <Accordion title="What happens if processing fails?">
    Mary will provide specific error information and suggest solutions. Common fixes include:

    * Correcting data format issues
    * Providing missing required information
    * Adjusting system configurations
    * Retrying with smaller batches
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Mary isn't recognizing my column headers. What should I do?">
    Try these solutions:

    1. Use standard header names (First Name, Last Name, Email, Company)
    2. Remove special characters from headers
    3. Specify the mapping directly in your conversation with Mary
    4. Check that your CSV is properly formatted
  </Accordion>

  <Accordion title="My contacts aren't appearing in my marketing automation system. What's wrong?">
    Check these common issues:

    1. Verify the correct destination program/list was specified
    2. Ensure you have proper permissions in your marketing automation system
    3. Check that the integration is properly configured
    4. Look for error messages in the processing feedback
  </Accordion>

  <Accordion title="How do I know if my list upload was successful?">
    Mary will provide confirmation including:

    * Number of contacts processed
    * Destination program/list information
    * Any errors or warnings
    * Next steps for campaign activation
  </Accordion>

  <Accordion title="Can I revert a list upload?">
    Contact your Marketing Operations team immediately. While there's no automatic revert function, they can help remove incorrectly uploaded contacts from your system.
  </Accordion>
</AccordionGroup>

## Best Practices

<AccordionGroup>
  <Accordion title="How should I prepare my CSV for the best results?">
    Follow these guidelines:

    1. Include as many relevant fields as possible
    2. Use clear, standard column headers
    3. Clean up obvious data errors beforehand
    4. Include metadata about the list source
    5. Test with a small sample first
  </Accordion>

  <Accordion title="When should I use enrichment vs. clean data upload?">
    Use enrichment when:

    * You have incomplete contact information
    * Job titles need standardization
    * You want to improve lead scoring accuracy
    * Data came from events or forms with limited fields
  </Accordion>

  <Accordion title="How often should I upload lists?">
    This depends on your campaign frequency:

    * Event-based: After each event or registration deadline
    * Campaign-based: As part of campaign preparation
    * Ongoing: Regular intervals based on lead generation
  </Accordion>
</AccordionGroup>

## Getting Help

<AccordionGroup>
  <Accordion title="Who should I contact if I need help with List Upload?">
    1. **During processing**: Ask Mary directly in the chat
    2. **Setup issues**: Contact your Marketing Operations team
    3. **Integration problems**: Check your system integration documentation
    4. **General questions**: Refer to this FAQ or the setup guide
  </Accordion>

  <Accordion title="How do I request new features or improvements?">
    Contact your Marketing Operations team who can work with allGood support to request enhancements or configuration changes.
  </Accordion>
</AccordionGroup>