Troubleshooting import multiple Miro boards to Confluence
If you encounter issues during your import, follow these steps to identify and resolve the problem.
Step 1: Check your import summary email
When your import is complete, you’ll receive a notification email with details about what was transferred. The email will list the spaces, pages, and users that were successfully imported. If part or all of your import couldn’t be completed, the email will include a brief message explaining the issue.
Use the table below to find your error message and follow the recommended troubleshooting steps.
Step 2: Identify your error scenario and follow the recommended troubleshooting steps
If part of your import was unsuccessful or failed:
Notification example | How to fix it |
|---|---|
5 users couldn’t be imported | Check the missing users' status in Miro and ensure they are not deactivated. Retry importing content that includes these users. If no users could be imported at all, ensure you entered the correct Miro User Access Token. Follow these step-by-step instructions to verify your token: Import multiple Miro boards to Confluence |
1 space couldn’t be created | If possible, make yourself the workspace owner in Miro. Otherwise, ask the workspace owner or a Miro admin to grant you ownership before retrying the import. |
11 whiteboards couldn’t be imported, or were imported incorrectly | Tip: If several boards failed, retry the full import. If only a few boards didn’t import, use the Single Miro Importer to import them individually. Import Miro boards in Confluence whiteboards Go to Miro and re-export the failed boards, ensuring they meet the following import file size and type requirement before retrying import: ✅ Is the file a Vector PDF?
✅ Is the file larger than 100MB?
✅ Does the board contain too many elements?
|
If the entire import failed:
Notification example | How to fix it |
|---|---|
Your import from Miro was unsuccessful. | Check the Miro import FAQ to see if any common scenarios apply. You can also retry the import process. If it fails again, try to reach out to support. |
Your import from Miro was unsuccessful. You have imported 37 users from Miro. | Check the Miro import FAQ to see if any common scenarios apply. You can also retry the import process. If it fails again, try to reach out to support. |
Your import from Miro was unsuccessful because we couldn’t get content from your export file. | To fix this, ensure that your uploaded file meets the following requirements:
Once confirmed, retry the import process. Need step-by-step instructions on how to export from Miro? See this guide |
Step 3: Contact support if you need further assistance
If you're unable to resolve the issue, open a support ticket via the Atlassian Support Portal.
Only product administrators can submit support tickets.
How to submit your request:
Open a support ticket via the Atlassian Support portal (if you are a product administrator).
Select Technical issues and bugs as your support category.
Include your Task ID in the details section of your support ticket → This helps our team diagnose the issue faster. You can find your Task ID in your import summary email.
Was this helpful?