Installation Guide
Install from Atlassian Marketplace
-
Access Atlassian Marketplace
Visit the Bulk Report Generator page on Atlassian Marketplace.
-
Install the App
Click "Get it now" and follow the installation prompts for your Confluence instance.
-
Grant Permissions
The app requires permissions to create and edit pages in your Confluence spaces.
-
Verify Installation
Go to any Confluence page and type
/bulkreportto verify the macro is available.
Quick Start Guide
Creating Your First Bulk Report
Open a Confluence Page
Navigate to any Confluence page where you want to add the bulk report generator.
Insert the Macro
Type /bulkreport and select the "Bulk Report Generator" macro from the suggestions.
Configure Your Settings
Follow the 4-step wizard to configure your space, template, and generation options.
Generate Reports
Click "Generate" to create your bulk reports automatically.
Basic Usage
/bulkreportComplete 4-Step Workflow
Space & Page Selection
Choose where your reports will be created in Confluence.
Page Creation Options
Select Your Template
Choose between pre-built templates or upload your own.
🎯 Simple Templates
- Pre-built templates with metrics and descriptions
- Ready-to-use catalog of professional reports
- Customizable in Step 3
📤 Upload Templates
- Clone existing Confluence pages using URLs
- Perfect for replicating existing report structures
- Skips Step 3 and goes directly to bulk generation
Enter the name for your report in this step.
Edit Your Template Simple Templates Only
Customize your template with an intuitive toggle button editor.
Editor Features
- ✏️ Toggle button editor (similar to Confluence page editing)
- 🎨 Customize template layout and content
- 📊 Modify metrics and descriptions
- 👀 Real-time preview of changes
Bulk Generation
Choose how you want to generate your reports.
Template System Explained
Simple Templates
What are Simple Templates?
Pre-built templates from our catalog with metrics and descriptions already filled out. Perfect for standard reporting needs.
Key Features:
- ✅ Ready-to-use professional templates
- ✅ Pre-configured metrics and KPIs
- ✅ Fully customizable in Step 3
- ✅ Best for standardized reporting
Workflow:
Step 1 → Step 2 → Step 3 (Edit) → Step 4
Upload Templates
What are Upload Templates?
Clone existing Confluence pages by providing their URLs. Ideal for replicating existing report structures across multiple projects.
Key Features:
- ✅ Clone any existing Confluence page
- ✅ Maintain existing formatting and structure
- ✅ Quick setup with URL input
- ✅ Perfect for established report formats
Workflow:
Step 1 → Step 2 → Skip Step 3 → Step 4
Bulk Generation Options
Single Report Generation
Create individual reports on-demand with immediate results.
Best for:
- One-time project reports
- Ad-hoc analysis
- Testing templates
Multiple Report Generation
Batch process multiple reports efficiently in one operation.
Best for:
- Department-wide reporting
- Multi-project analysis
- Bulk documentation creation
Scheduled Dated Reports
Automate regular reporting with flexible scheduling options.
Troubleshooting
Common Issues
Macro not appearing when typing /bulkreport
Solution:
- Verify the app is installed in your Confluence instance
- Check if you have permissions to use macros
- Try refreshing the page and typing the command again
Cannot create reports in selected space
Solution:
- Ensure you have "Create" permissions in the target space
- Contact your Confluence administrator for space permissions
- Try selecting a different space where you have full access
Template editing not working
Solution:
- This feature is only available for Simple Templates
- Upload Templates skip the editing step
- Clear browser cache and try again
Scheduled reports not generating
Solution:
- Verify the macro is still present on the original page
- Check space permissions haven't changed
- Contact support if issues persist
Performance Tips
- 📊 Keep templates focused and concise for better performance
- ⏱️ Schedule bulk operations during off-peak hours
- 📝 Test templates with single reports before bulk generation
- 🔄 Use batch processing for multiple reports instead of individual creation
Frequently Asked Questions
Yes, absolutely. The Bulk Report Generator is built on Atlassian Forge platform, which ensures all processing happens within your Confluence environment. No data is transmitted to external servers.
Currently, the app is designed for Confluence Cloud only. Forge apps are not compatible with Server or Data Center instances.
There's no hard limit set by the app, but we recommend generating reports in batches of 50 or fewer for optimal performance. Larger batches may take longer to process.
The template modifications apply to new reports only. Existing reports remain unchanged. You can always edit individual reports manually in Confluence.
Scheduled reports will stop generating if the original macro page is deleted. The previously generated reports will remain intact, but no new reports will be created.
Yes, since reports are standard Confluence pages, you can export them using Confluence's built-in export features (PDF, Word, etc.).
Support & Contact
📚 Resources
About DataPingo
DataPingo specializes in creating powerful automation tools for business applications. We're committed to helping teams streamline their workflows and boost productivity.