Configuring Settings - Magic Merge Knowledge Base

Configuring Settings

Magic Merge offers flexible settings to customize how the application works in your Salesforce environment. This guide covers the key configuration options and best practices for setup.

Accessing Settings

To access Magic Merge settings:

  1. Open the Magic Merge app in Salesforce
  2. Click the Settings tab in the navigation bar
  3. Select the appropriate settings category from the left sidebar

Note: You need administrator permissions to modify most Magic Merge settings.

General Settings

Default Output Format

Choose the default file format for merged documents (PDF, DOCX, XLSX). This can be overridden at the template level.

File Storage Location

Specify where generated documents should be stored:

  • Salesforce Files - Store documents in the Files section
  • Record Attachments - Attach documents directly to records
  • Both - Store in Files and attach to records

Document Naming Convention

Set a default naming pattern for generated documents. You can use merge fields to create dynamic file names like {!Account.Name}_Invoice_{!TODAY}.

Email Settings

From Address

Configure the default "from" email address for merge emails. You can use:

  • Organization-wide email addresses
  • Current user's email
  • Specific email addresses verified in Salesforce

Email Templates

Link Magic Merge to your Salesforce email templates or create custom templates within the app. Configure default subject lines, body content, and CC/BCC recipients.

Send Behavior

Choose when emails are sent:

  • Immediate - Send as soon as documents are generated
  • Scheduled - Queue emails for specific times
  • Manual Review - Require approval before sending

Performance Settings

Batch Size

Set the number of records processed per batch for large merge jobs. Lower values reduce system load but increase processing time.

Timeout Settings

Configure maximum processing time for individual merges to prevent long-running jobs from consuming resources.

Security & Permissions

User Permissions

Define which users or profiles can:

  • Create and edit templates
  • Run merge jobs
  • Schedule automated merges
  • Access merge history and logs

Data Access

Magic Merge respects Salesforce sharing rules and field-level security. Configure whether the app should run in:

  • User Mode - Respects user's permissions
  • System Mode - Access all data (requires admin approval)

Common Questions

Do I need to configure settings before using Magic Merge?

No. Magic Merge comes with sensible defaults. However, customizing settings to match your organization's needs will improve the user experience.

Can different users have different settings?

Most settings are organization-wide, but individual users can set personal preferences for things like default templates and notification preferences.

What happens if I change settings while merges are running?

Active merge jobs continue with the settings they started with. New settings apply to jobs initiated after the change.

Best Practice: Test configuration changes in a sandbox environment before deploying to production to ensure they work as expected.