📄 Word Export Block

📋 Overview

The Word Export Block allows you to automatically generate personalized Word documents using your own templates and AI-generated content. This functionality transforms content created in your application into professional .docx documents, ready to be used.

🔄 Migration from Word V1 (Legacy)

⚠️ Important: Word Block Evolution

⚠️ Legacy Notice: The old version of the Word Block (Word V1 - Legacy) is no longer recommended for new projects.

📜 Legacy Version Behavior

This historical version worked on a simple principle: it was sufficient for the Word V1 block to be parent to all content to export and it took all content as one piece to place it in the generated document.

🚀 Fundamental Difference with New Version

🔧 New Requirements

The new Word Export Block introduces a variable system that requires at minimum one variable (in {{~~content}} format) in your template, even to reproduce the simple behavior of the old version.

⚡ Enhanced Capabilities

This evolution brings considerably increased power:

Header and footer feeding

Variables positioned in tables

Specifically formatted elements

Content distributed between cover pages and appendices

Precise control of document structure

📘 Migration Path: If you used Word V1 to simply export all your content at once, now create a template with a {{~~main_content}} variable and use the automatic mode of the new block.

📝 Word Template Preparation

🎨 Template Creation

📄 Create Template

Before configuring your Word Export Block, you must prepare a Word template (.docx) that will serve as the base for your documents.

🎨 Design Elements

This template can contain:

Your graphic charter and formatting

Custom headers and footers

Tables, images and structural elements

Variables positioned at desired locations

🔧 Variable Syntax

For Thinkeo to automatically feed your template, you must use specific syntax to mark dynamic content locations:

🎯 Standard

{{~~variable_name}}

Most versatile format, ideal for paragraphs and long texts

⚙️ Inline

{{~variable_name}}

Use when encountering formatting issues with standard format, allows better Word style preservation

📋 Alternative

{{~~~variable_name}}

Use when encountering formatting issues with tables

✅ Core Concept: The fundamental idea is that Thinkeo generates content via AI, then automatically feeds the different variables positioned in your Word template.

📏 Variable Naming Rules

✅ Valid Requirements

No spaces: Use underscores to separate words (ex: title_introduction)

No hyphens: Avoid the - character in variable names

No numbers at start: Variables cannot start with a digit (ex: section_1 is correct, 1_section is not)

Not only numbers: A variable cannot consist only of digits

📝 Examples

Valid names:

{{~~main_title}}

{{~~content_section_2}}

{{~~final_conclusion}}

Invalid names:

{{~~main title}} (contains space)

{{~~main-title}} (contains hyphen)

{{~~2_section}} (starts with number)

{{~~123}} (only numbers)

🖼️ Image Management

Word and PowerPoint blocks now support dynamic image integration with several syntaxes:

📸 Image Variables

Use the special format for image variables in your template:

{{%image_variable_name}}

🔍 Extract Images from Blocks

To extract an image from a paragraph block containing a single image, use this syntax in the Word block mapping (not in the template):

{{ blocks["block_id"] | extract_first_link_html }}

Important: Replace block_id with the actual block UUID from Thinkeo. This goes in the variable mapping configuration of the Word block, not in the template itself.

🔄 Template Image Replacement

Add the image variable as alt-text of an existing image in your template

The exported image will automatically take the dimension of the template reference image

This approach allows dynamic modification of logos, product images, or covers according to user selections

⚙️ Word Export Block Configuration

🏗️ Block Creation

➕ Add Block

In your application, add a new Word Export Block

📤 Import Template

Upload your Word file (.docx) containing the variables

🔍 Automatic Detection

The system automatically analyzes your template and detects all present variables

✅ Validation

Verify that all your variables are correctly recognized in the interface

🎛️ Operating Modes

The Word Export Block offers two distinct approaches according to the desired level of control.

🤖 Automatic Mode: AI Generation Enabled

🔧 Operating Principle

In this mode, AI automatically manages content distribution in the different variables of your template. This approach is ideal for quick and simple implementation.

⚙️ Configuration

✅ Enable Option

Check "AI Generation" during block configuration

🧩 Child Blocks

Add your content blocks (texts, web searches, etc.) as nested blocks

💬 Additional Prompt

Use the additional prompt field to guide AI in content distribution

🎯 Explicit Variables

The more descriptive your variable names (ex: {{~~introduction}}, {{~~conclusion}}), the more precise AI will be in its placement

⚡ Advantages

🚀 Quick Setup

Fast and intuitive configuration

🔄 Adaptive AI

AI automatically adapts to available content

🎯 Efficiency

Very effective with well-named variables and detailed additional prompt (if necessary)

🎯 Manual Mode: Precise Mapping Control

🔧 Operating Principle

This mode gives you total control over the correspondence between each content block and each template variable. It requires more configuration but offers maximum precision.

🏗️ Recommended Architecture

For optimal management, structure your blocks according to this hierarchy:

📄 Main Content Blocks

Generate global content for the document via AI blocks

🔍 Extraction Blocks

Create additional AI blocks to isolate specific elements (introduction, development, conclusion, etc.)

🔗 Precise Mapping

Associate each template variable with a specific extraction block

📊 Structure Example

AI Block "Executive Summary" (extracts the summary)
└── AI Block "Report Content" (shared block - generates all document content)

AI Block "Introduction" (extracts the introduction)  
└── AI Block "Report Content" (shared block - same block as above)

AI Block "Main Analysis" (extracts the document body)
└── AI Block "Report Content" (shared block - same block as above)

AI Block "Recommendations" (extracts the recommendations)
└── AI Block "Report Content" (shared block - same block as above)

🔧 Mapping Configuration

🆔 Retrieving Block and Attribute IDs

Before configuring your Word Export Block with manual mapping or image extraction, you'll need to retrieve the specific IDs of your attributes and blocks.

📊 Attribute IDs

Attributes allow you to send your files and data to Thinkeo for use in the App.

📋 Access Attributes Page

You can find their IDs in the Attributes page, then by clicking on one of the attributes.

🔍 View Attribute Details

📋 Copy ID

You can click on the icon next to the ID to copy it with one click.

🧩 Block IDs

🎯 Select Block

In the Studio, by selecting a block from the hierarchy or central panel, click on the icon corresponding to the block parameters.

🆔 Access Block ID

From there you will have access to the block ID, which can also be copied/pasted with one click.

🔗 Alternative Method

To do this, click on the "..." of a block from the tree view, select "open in new tab" then retrieve the ID.

📘 Usage Context: These IDs are essential when using manual mapping mode or when configuring image extraction from specific blocks. Always copy the complete UUID without modification.

❌ Disable AI

Uncheck the "AI Generation" option

🆔 ID Attribution

For each detected variable, select the corresponding block or attribute using the IDs you retrieved

✅ Mapping Validation

Verify that each variable has its assigned source block

📊 Results and Best Practices

🏆 Rendering Quality

Both modes generate quality documents:

🤖 Automatic Mode

Effective with explicit variables and a well-written additional prompt

🎯 Manual Mode

Offers granular control over placement of each content element

💡 Recommendations

🏗️ Block Structure

Essential Point: The Word Export Block must be parent to all your content blocks to have them available and be able to export them

If you want manual mapping, break down your block structure into as many sub-parts as necessary so each variable has a corresponding block or attribute

🎯 Mode Choice

Automatic Mode: Ideal with well-named variables and well-adjusted additional prompt

Manual Mode: Favor this approach when you want to precisely target what specific content should be placed at what location in the document

⚡ Optimization

Use very explicit variable names in your templates (ex: project_introduction, financial_analysis)

Write a detailed additional prompt to guide AI in distribution (automatic mode)

Document your mapping for easier maintenance (manual mode)

🎨 Template Optimization

Favor the {{~~variable}} format except for formatting problems

Test both tilde formats according to your style needs

Maintain consistency in your variable names

Exploit Word capabilities: headers, footers, tables, custom styles

📘 Table Styles: The Word block automatically uses the default table style if it exists in your template. In the absence of a default style, the system applies the "Thinkeo Table" style for all generated tables. The triple tilde format {{~~~variable}} remains recommended to resolve formatting issues in tables.

🎉 Conclusion

The Thinkeo Word Export Block offers you a powerful solution to automate the creation of professional Word documents. This new version far exceeds Word V1 capabilities thanks to its variable system that allows fine control of document structure.

Whether you choose automatic mode for its ease of use or manual mode for precise control, the essential lies in preparing your template with explicit variables and understanding how to retrieve the necessary IDs for precise mapping.

The key to success is found in the hierarchical organization of your blocks: the Word Export Block as parent and your content blocks as children. This structure, combined with descriptive variable names and, depending on the chosen mode, a detailed additional prompt or precise mapping, guarantees quality results.

Don't hesitate to experiment with both modes according to your projects: automatic mode will save you time on standardized structures, while manual mode will give you total control over documents with specific needs.

📄 Word Export Block

📄 Word Export Block#

📋 Overview#

🔄 Migration from Word V1 (Legacy)#

⚠️ Important: Word Block Evolution#

📜 Legacy Version Behavior#

🚀 Fundamental Difference with New Version#

🔧 New Requirements#

⚡ Enhanced Capabilities#

📝 Word Template Preparation#

🎨 Template Creation#

🔧 Variable Syntax#

📏 Variable Naming Rules#

✅ Valid Requirements#

📝 Examples#

🖼️ Image Management#

⚙️ Word Export Block Configuration#

🏗️ Block Creation#

🎛️ Operating Modes#

🤖 Automatic Mode: AI Generation Enabled#

🔧 Operating Principle#

⚙️ Configuration#

⚡ Advantages#

🎯 Manual Mode: Precise Mapping Control#

🔧 Operating Principle#

🏗️ Recommended Architecture#

📊 Structure Example#

🔧 Mapping Configuration#

🆔 Retrieving Block and Attribute IDs#

📊 Attribute IDs#

🧩 Block IDs#

📊 Results and Best Practices#

🏆 Rendering Quality#

🤖 Automatic Mode#

🎯 Manual Mode#

💡 Recommendations#

🎉 Conclusion#

📄 Word Export Block

📋 Overview

🔄 Migration from Word V1 (Legacy)

⚠️ Important: Word Block Evolution

📜 Legacy Version Behavior

🚀 Fundamental Difference with New Version

🔧 New Requirements

⚡ Enhanced Capabilities

📝 Word Template Preparation

🎨 Template Creation

🔧 Variable Syntax

📏 Variable Naming Rules

✅ Valid Requirements

📝 Examples

🖼️ Image Management

⚙️ Word Export Block Configuration

🏗️ Block Creation

🎛️ Operating Modes

🤖 Automatic Mode: AI Generation Enabled

🔧 Operating Principle

⚙️ Configuration

⚡ Advantages

🎯 Manual Mode: Precise Mapping Control

🔧 Operating Principle

🏗️ Recommended Architecture

📊 Structure Example

🔧 Mapping Configuration

🆔 Retrieving Block and Attribute IDs

📊 Attribute IDs

🧩 Block IDs

📊 Results and Best Practices

🏆 Rendering Quality

🤖 Automatic Mode

🎯 Manual Mode

💡 Recommendations

🎉 Conclusion