Data Tab - Complete User Guide
The Data Tab is your central hub for managing all data sources, files, and content that power your Word documents.
---
📑 Table of Contents
- Overview
- Sub-Tab: Files
- Sub-Tab: Sources
- Sub-Tab: Import
- Sub-Tab: Sync
- Sub-Tab: Media
- Sub-Tab: Packages
- Quick Reference
- Common Workflows
---
Overview
The Data Tab contains 6 sub-tabs organized in two rows:
Row 1:
- 📁 Files - Manage CSV data files and Word templates
- 🔌 Sources - Connect to live data sources
- 📥 Import - Import data directly into documents
- 🔄 Sync - Manage automatic data synchronization
- 🖼️ Media - Organize image libraries
- 📦 Packages - Access pre-built email campaign packages
Each sub-tab is designed for a specific aspect of data management. Let's explore each one in detail.
---
Sub-Tab: Files
Purpose: Store and manage static data files and Word templates that you'll use repeatedly in your document generation.
📂 Data Files Section
Upload and manage CSV or Excel files containing the data you want to merge into Word documents.
What You Can Do
Upload a Data File:
- Click the "Import Data File" button
- Select a CSV or Excel file from your computer
- Your file is uploaded and stored securely in your account
- File appears in the list with metadata (name, size, row count, column count, upload date)
Each file card shows:
- File name and original filename
- Row count - Total number of data rows
- Column count - Number of fields/columns
- Upload date - When you uploaded it
- File size - Storage size
| Button | Icon | What It Does |
|--------|------|--------------|
| Insert Fields | 📋 | Opens a list of all columns in your data file. Select fields to insert as placeholders (like <) into your current Word document. |
| Sort Data | ↕️ | Reorder your data rows based on any column (ascending or descending). Useful for organizing output before document generation. |
| View Data | 👁️ | Opens an interactive data viewer with:
• Full table view of all data
• Search across all fields
• Column filtering
• Sortable columns
• Export capabilities |
| Download | ⬇️ | Download the original file back to your computer for offline editing. |
| Delete | 🗑️ | Permanently remove the file from your account. Requires confirmation. |
Example Use Case
Scenario: You have a customer list in Excel with columns: FirstName, LastName, Email, PurchaseAmount
Steps:
- Upload the Excel file using "Import Data File"
- Click "Insert Fields" to see all columns
- Select "FirstName" - it inserts
<at your cursor> - Type some text, then insert more fields
- Your template might look like:
Dear <> < >,
---
📄 Word Templates Section
Upload and store Word document templates (.docx files) that already contain placeholders and formatting.
What You Can Do
Upload a Template:
- Click "Upload Template" button
- Select a .docx file from your computer
- Template is saved to your account
- Use it later by loading it into the current document
- Design your template in Word with placeholders
- Click "Save Current Doc" button
- Give it a name
- Your current document is saved as a reusable template
- Click the "Load" button on any template
- The template's content is inserted into your current Word document using OOXML magic
- All formatting, styles, and placeholders are preserved
- Download - Get the .docx file back to your computer
- Delete - Remove from your account
Example Use Case
Scenario: You've created a beautiful invoice template with your company logo, formatting, and placeholders
Steps:
- Design the invoice in Word with placeholders:
<,> <, etc.> - Click "Save Current Doc" and name it "Invoice Template"
- Later, open a blank document
- Go to Data → Files → Word Templates
- Click "Load" on your Invoice Template
- Template appears in the document, ready for data merge
---
Sub-Tab: Sources
Purpose: Connect to external live data sources like Google Sheets, Microsoft Excel, Airtable, or SQL Server databases.
🔌 Live Data Connections
Instead of uploading static CSV files, connect directly to your cloud spreadsheets or databases for real-time data access.
Available Connections
| Source | Description | Authentication |
|--------|-------------|----------------|
| Google Sheets | Connect to spreadsheets in your Google Drive | OAuth (sign in with Google) |
| Microsoft Excel | Connect to Excel files in OneDrive/SharePoint | OAuth (sign in with Microsoft) |
| Airtable | Connect to Airtable bases | API Key + Base ID |
| SQL Server | Connect to SQL Server databases | Username/Password or Windows Auth |
How to Connect
Google Sheets:
- Click the "Google Sheets" tile (green)
- A popup opens for Google login
- Sign in and grant permissions
- Connection appears in the "Connected Data Sources" list
- Click the "Microsoft Excel" tile (green/dark green)
- Sign in with your Microsoft account
- Grant permissions
- Connection appears below
- Click the "Airtable" tile (yellow)
- Enter your API Key (from Airtable account settings)
- Enter your Base ID (from the Airtable URL)
- Click "Test & Connect"
- Connection appears if successful
- Click the "SQL Server" tile (red)
- Enter connection details:
- Database name
- Choose authentication method:
- Windows Authentication (no username/password needed)
- SQL Server Authentication (enter username and password)
- Click "Test & Connect"
- Connection appears if successful
Managing Connections
View Connection Details:
Each connected source shows:
- Source type and name
- Connection status (green = active)
- Available tables/sheets count
- Connection date
- Test Connection - Verify the connection is still active
- Refresh - Reload the list of available tables
- Edit - Update connection settings
- Delete - Remove the connection (requires confirmation)
Example Use Case
Scenario: Your team maintains a Google Sheet with product inventory that updates daily
Steps:
- Go to Data → Sources
- Click "Google Sheets" tile
- Sign in with Google
- Connection established
- Now you can import data from any sheet in your Google Drive without uploading CSV files
---
Sub-Tab: Import
Purpose: Pull data from your connected sources directly into the Word document using a guided wizard.
📥 Data Import Wizard
A 4-step wizard that guides you through selecting, configuring, previewing, and inserting live data.
Step 1: Select Data Source
What You See:
- List of all your connected data sources (from the Sources tab)
- Each source shows its type, name, and status
- Click on the data source you want to import from
- Example: Click on "Google Sheets" if you want data from a spreadsheet
Step 2: Select Table/Sheet
What You See:
- List of all available tables, sheets, or bases from your selected source
- Google Sheets shows all sheets in your spreadsheets
- SQL Server shows all tables in the database
- Excel shows all worksheets
- Click on the specific table or sheet containing your data
- Click "Next" or the table card directly
Step 3: Configure Import
What You See:
- List of all columns in your selected table/sheet with checkboxes
- Import format options
- Advanced settings
| Option | Description |
|--------|-------------|
| Select Columns | Check which columns you want to include. Uncheck columns you don't need. |
| Import Format | Choose how data appears in Word:
• Table - Formatted Word table
• List - Bulleted or numbered list
• Merge Fields - Insert placeholders only |
| Row Limit | Limit how many rows to import (default: 100). Enter 0 for all rows. |
| Enable Auto Sync |
| Sync Frequency | If auto sync enabled, choose: Hourly, Daily, or Weekly |
What To Do:
- Check the columns you want
- Select your preferred format
- Set row limit if needed
- Enable auto-sync if you want automatic updates
- Click "Next: Preview"
Step 4: Preview & Insert
What You See:
- Preview table showing the first 5 rows of your data
- Exactly how it will appear in Word
- Summary of your selections
- Review the preview
- If it looks good, click "Insert into Document"
- If not, click "Back" to adjust settings
- Data is inserted at your cursor position in Word
- If you enabled auto-sync, a schedule is created automatically (see Sync tab)
- Success message confirms completion
Example Use Case
Scenario: You need to create a report with the latest sales figures from your company's SQL Server database
Steps:
- Go to Data → Import
- Click your "SQL Server" connection
- Select the "SalesData" table
- Check columns: SalesRep, Product, Amount, Date
- Choose format: "Table"
- Set row limit: 50 (top 50 records)
- Enable auto-sync: ✅ (Daily at midnight)
- Click "Preview"
- Review the data
- Click "Insert into Document"
- Formatted table appears in Word with live data
- Every night at midnight, your data automatically updates!
---
Sub-Tab: Sync
Purpose: Manage automatic synchronization schedules that keep your Word documents updated with the latest data from connected sources.
🔄 Automatic Sync Schedules
When you import data with "Enable Auto Sync" checked, a schedule is created here. You can view, manage, and manually trigger syncs.
What You See
List of all your sync schedules, showing:
| Info | Description |
|------|-------------|
| Data Source | Name and type of the connected source (e.g., "Google Sheets") |
| Table/Sheet | Specific table or sheet being synced |
| Frequency | Color-coded badge:
🟢 Hourly - Every hour
🔵 Daily - Once per day
🟣 Weekly - Once per week |
| Last Sync | When it last updated (e.g., "5 minutes ago", "2 hours ago") |
| Next Sync | When it will update next (only shown if enabled) |
| Status | Toggle switch - ON (active) or OFF (paused) |
Actions You Can Take
Enable/Disable Schedule:
- Use the toggle switch to turn automatic syncing on or off
- When OFF, data won't auto-update (but schedule is preserved)
- Turn it back ON anytime to resume
- Click the "Sync Now" button to immediately update the data
- Useful when you need the latest data right now without waiting for the schedule
- Last Sync time updates
- Click the "Delete" (🗑️) button to permanently remove the schedule
- Confirmation dialog appears to prevent accidental deletion
- You can recreate the schedule by re-importing with sync enabled
- Click the "Refresh" button (🔄) at the top to reload the schedules
- Useful if you created schedules from another device
How Syncing Works
- At the scheduled time (or when you click "Sync Now"), the system:
- Fetches the latest data from the specified table/sheet
- Updates the data in your Word document
- Preserves all formatting and styles
- Important Notes:
- If Word is closed during a scheduled sync, it will run at the next scheduled time when Word is open
- Synced content in Word is marked with special identifiers so the system knows what to update
Example Use Case
Scenario: You have a weekly sales report that needs to show live inventory data
Setup:
- Import your inventory data with "Enable Auto Sync" ✅
- Choose "Daily" frequency
- Schedule appears in the Sync tab
- Every day at midnight, your inventory data automatically updates
- You open Word in the morning and see fresh data
- If you need data immediately, click "Sync Now"
- Before a big presentation, temporarily disable sync to "freeze" the data
- If the data source changes, delete the old schedule
- Re-import from the new source with sync enabled
- New schedule replaces the old one
---
Sub-Tab: Media
Purpose: Organize images and graphics into libraries for easy insertion into documents using placeholders.
🖼️ Graphics Libraries
Instead of inserting images manually each time, upload them to libraries and reference them by name in your templates.
What Are Graphics Libraries?
A library is a named collection of images. Think of it like a folder.
Examples:
- "Product Photos" - Contains images of all your products
- "Employee Headshots" - Team member photos
- "Company Logos" - Your brand assets
- "Real Estate Listings" - Property photos
How to Create a Library
- Click "Create Library" button
- Enter a library name (e.g., "Product Images")
- Optionally add a description
- Click "Create"
- Your new library appears in the list
How to Upload Images to a Library
- Click on a library card to expand it
- Click "Upload Images" button
- Select one or multiple image files (JPG, PNG, GIF, etc.)
- Images are uploaded and tagged with their filenames
- Each image appears in a gallery view with its name
Using Images in Documents
Method 1: Image Placeholder Syntax
``
[[ImageName]]
`
Example:
- You have a library called "Products"
- It contains an image file named "laptop.jpg"
- In your Word template, type: [[laptop.jpg]]
- During document generation, the placeholder is replaced with the actual image
`
[[LibraryName/ImageName]]
`
Example:
`
[[Products/laptop.jpg]]
[[Logos/company-logo.png]]
`
Method 3: Using InsertImage Function
`
{{InsertImage|Products/laptop.jpg|2|3}}
`
- Parameters: ImagePath, WidthInInches, HeightInInches
Managing Your Libraries
Each Library Card Shows:
- Library name and description
- Image count
- Creation date
- Thumbnail preview of first image
- View Gallery - See all images in a visual grid
- Upload Images - Add more images to the library
- Download Library - Download all images as a ZIP file
- Rename - Change the library name
- Delete Library - Remove library and all images (requires confirmation)
- View Full Size - Click an image to see it larger
- Copy Name - Click to copy the image name for use in placeholders
- Download - Download individual image
- Delete Image - Remove from library
Example Use Case
Scenario: Creating a product catalog with 50 products
Setup:
- Go to Data → Media
- Click "Create Library"
- Name it "ProductCatalog2026"
- Click "Upload Images"
- Select all 50 product photos
- Images upload and are named: "product-001.jpg", "product-002.jpg", etc.
In your Word template:
`
Product Name: <
Product ID: <
[[product-<
Price: $<
`
Result:
- When you merge data, each product record shows its corresponding image
- If ProductID is "001", it inserts [[product-001.jpg]]
- The system finds that image in your ProductCatalog2026 library and inserts it
---
Sub-Tab: Packages
Purpose: Access pre-built email campaign packages that are ready for use with Power Automate. These packages are generated from the Actions → Export tab.
📦 Power Automate Email Flow Packages
When you create an email campaign export (in the Actions tab), it appears here as a downloadable package.
What's in a Package?
Each email campaign package (ZIP file) contains:
| Item | Description |
|------|-------------|
| Merged Email Bodies | Individual HTML email files, one per recipient, with all data merged |
| Email Data CSV | Spreadsheet with recipient info: name, email, subject, body filename |
| Attachments (optional) | If you generated merged attachments (Word docs), one per recipient |
| Static Files (optional) | Shared files like company logos or PDFs |
| flow.json | Pre-configured Power Automate flow (import and run immediately!) |
| README.txt | Instructions for importing and running the flow |
What You See
List of all your email campaign packages:
Each Package Card Shows:
- Campaign Name - Name you gave it when creating the export
- Export Date - When it was generated
- Recipient Count - How many emails in the package
- Package Size - Total ZIP file size
- Template Used - Which email template was used
- Status - "Ready" (green badge)
Actions You Can Take
View Details:
- Click "View Details" to see:
- Email subjects
- Attachment info
- File listing
Download Package:
- Click "Download" (⬇️) button
- ZIP file downloads to your computer
- Extract it and you're ready for Power Automate
- Click "Delete" (🗑️) button
- Removes package from server (can't be undone)
- Confirmation dialog appears first
How to Use a Package
In Power Automate:
- Download the package ZIP
- Extract the ZIP file
- Open Power Automate (flow.microsoft.com)
- Click "Import" → "Import Package (.zip)"
- Select the flow.json
file - Flow is imported with your server URL and auth token already configured!
- Click "Run" - emails start sending automatically
- Server URL points to your Data Publisher backend
- Authentication token is embedded (secure)
- No manual configuration needed!
Example Use Case
Scenario: Send personalized holiday cards to 500 customers
Steps:
- Create an HTML email template with placeholders: <
> ,<> , etc. - Upload customer data CSV (500 rows)
- Go to Actions → Export → Create Email Campaign Export
- Select template, data file, configure settings
- Click "Generate Export"
- System generates 500 individual HTML emails (takes a few minutes)
- Package appears in Data → Packages
- Click "Download"
- Import into Power Automate
- Run the flow - 500 personalized emails sent!
- All email bodies pre-rendered (fast sending)
- No need to manually configure Power Automate
- Attachments ready if needed
- Tracking and analytics built in
---
Quick Reference
Which Sub-Tab Do I Need?
| I Want To... | Go To | What To Do |
|--------------|-------|------------|
| Upload a CSV file | Files | Click "Import Data File", select CSV |
| Save my Word template | Files → Word Templates | Click "Save Current Doc" |
| Connect to Google Sheets | Sources | Click "Google Sheets" tile, sign in |
| Get live data into Word | Import | Use the 4-step wizard |
| Auto-update data daily | Import | Enable "Auto Sync" in Step 3, then manage in Sync |
| Upload product images | Media | Create a library, upload images |
| Reference images by name | Media | Use [[imagename.jpg]] syntax in template |
| Download email campaign | Packages | Click "Download" on your export package |
| See what auto-syncs are active | Sync | View all schedules, toggle on/off |
---
Common Workflows
Workflow 1: Static Data (CSV File) → Document
Goal: Generate documents from a CSV file
Steps:
- Data → Files → Click "Import Data File" → Upload CSV
- Data → Files → Click "Insert Fields" → Add placeholders to Word
- Actions → Merge → Select file → Generate documents
---
Workflow 2: Live Data (Google Sheets) → Document with Auto-Update
Goal: Create a report that auto-updates daily from Google Sheets
Steps:
- Data → Sources → Click "Google Sheets" → Sign in
- Data → Import:
- Select your spreadsheet/sheet
- Check columns
- Format: Table
- Enable Auto Sync ✅
- Frequency: Daily
- Click "Insert"
- Data → Sync → Verify schedule created
- Done! Data updates every day automatically
---
Workflow 3: Product Catalog with Images
Goal: Create a catalog with 100 products and their images
Steps:
- Data → Media → Create Library ("Products2026") → Upload 100 product images
- Data → Files → Import CSV with columns: ProductName, ProductID, Price
- In Word, create template:
<>
ID: <>
[[Products2026/product-<>.jpg]]
Price: $<>
``
- Actions → Merge → Select data → "One Per Page" → Generate
- Result: 100-page catalog with text and images merged!
---
Workflow 4: Email Campaign for 500 Customers
Goal: Send personalized emails with attachments
Steps:
- Data → Files → Upload customer CSV (500 rows)
- Data → Packages → Upload HTML email template
- Actions → Export → Email Campaign Wizard:
- Select customer data
- Configure subject, attachments
- Click "Generate Export"
- Wait for processing (few minutes)
- Data → Packages → Click "Download" on completed package
- Import into Power Automate → Run flow → 500 emails sent!
---
Tips for Success
Files Tab
- ✅ Use descriptive names for data files ("Q4_Sales_2026.csv" not "data.csv")
- ✅ Keep files under 10MB for best performance
- ✅ Use "View Data" to verify data loaded correctly before merging
- ⚠️ Deleting a file is permanent - download a backup first if needed
Sources Tab
- ✅ Test connections after creating them
- ✅ Keep API keys and credentials secure
- ✅ Refresh connections if you get errors (network issues)
- ⚠️ SQL Server requires network access to the database
Import Tab
- ✅ Preview data before inserting (Step 4)
- ✅ Use row limits for testing (import 10 rows first)
- ✅ Enable auto-sync only if you want automatic updates
- ⚠️ Importing large datasets (1000+ rows) may take time
Sync Tab
- ✅ Disable syncs before presenting to "freeze" data
- ✅ Use "Sync Now" when you need immediate updates
- ✅ Check "Last Sync" to verify schedules are working
- ⚠️ Syncs only work when Word and add-in are running
Media Tab
- ✅ Use consistent naming: "product-001.jpg", "product-002.jpg"
- ✅ Organize by project or category (separate libraries)
- ✅ Use lowercase filenames to avoid case sensitivity issues
- ⚠️ Image file sizes should be reasonable (< 5MB each)
Packages Tab
- ✅ Download packages immediately after generation
- ✅ Keep a local backup of campaign packages
- ✅ Delete old packages to free up server space
- ⚠️ Packages can be large (100+ MB for campaigns with attachments)
---
Need More Help?
- Quick Start Guide: See USER_GUIDE.md for basic concepts
- Actions Tab: See ACTIONS_TAB_GUIDE.md for document generation and merging
- Template Syntax: See INTERFACE_GUIDE.md for placeholder syntax
- Troubleshooting: See TROUBLESHOOTING.md for common issues
---
You now have complete control over your data sources! The Data Tab is your command center for everything that goes into your Word documents.
🎉 Ready to create amazing documents? Head over to the Actions Tab to start merging! 🎉