🧾 User Documentation: Auto Word Generator

📘 Overview

This website allows you to automatically generate multiple Word documents using:

1. A Word template (.docx) file containing placeholders (variables) inside curly brackets { }.
2. An Excel (.xlsx) file containing data that matches these variables.

Each row in the Excel file will create a new Word document with the variables replaced by the corresponding cell values.

⚙️ How It Works

1. Upload a Word Template (.docx)

The Word file should contain variables in the following format:

Dear {first-name},

Your grade in {course-name} is {grade}.

Each variable:

• Must be one word or use hyphens (-) between words.
• ✅ Correct: {first-name}
• ❌ Wrong: {first name} (spaces not allowed)

2. Upload an Excel File (.xlsx)

The Excel file must contain columns with names that match the variables in the Word file.

first-name	course-name	grade
John	Math	A
Sarah	Physics	B+

3. Generate Documents

After uploading both files, click on the "Generate" button. The system will:

1. Read the Excel file
2. Replace each variable in the Word template with the corresponding value from each row
3. Generate one Word file per row

4. Download Results

Once all documents are generated, you can download them as a ZIP file. Note: You must be logged in to download files.

💡 Example Workflow

1. Upload template.docx containing:

Hello {student-name},

Your ID is {student-id} and your score is {score}.

2. Upload data.xlsx containing:

student-name	student-id	score
Mohamed	2025	95
Salma	2030	88

3. Click Generate → You'll get:

• Mohamed_2025.docx
• Salma_2030.docx
• Both files inside one ZIP for download

⚠️ Notes & Best Practices

• Ensure all column names in Excel exactly match the Word placeholders
• Avoid using spaces or special characters in variable names
• Use UTF-8 compatible Word and Excel files (to support Arabic or other languages)
• Do not refresh the page while generation is in progress
• You must login to download generated files