AEM Sidekick Errors
In case of a problem, AEM Sidekick will display an appropriate error message. The following table contains all possible error messages and their likely root causes.
For more information on backend error codes and error message templates from the Admin API, see Admin Errors.
| Message | Likely Root Cause |
| Unable to fetch $1 from $2. | The backend was unable to retrieve the requested resource. |
| Unable to preview $1: empty file | The file intended for preview is empty. |
| Unable to preview $1: file larger than 100MB | The file exceeds the maximum allowed size for preview. |
| Unable to preview $1: ICO is larger than 16KB | The ICO file size exceeds the allowed limit. |
| Unable to preview $2: invalid JSON | The JSON data is malformed or not parsable. |
| Unable to preview $1: MP4 bit rate is higher than 300KB/s | The video’s bitrate is too high, exceeding the processing limits. |
| Unable to preview $1: MP4 is longer than 2 minutes | The MP4 video exceeds the allowed duration for preview. |
| Unable to preview $1: expected $2 but found $3 | There is a mismatch between the expected media type and the actual file type provided. |
| Content type header is missing | The server response is missing the Content-Type header, leading to processing issues. |
| Unable to preview $1: no handler found | No available handler exists to process the given file type. |
| File not found. Source document either missing or not shared with AEM. | The source file is missing or not properly shared with AEM. |
| Unable to preview $1: SVG contains invalid XML | The SVG file has invalid XML, making it unprocessable. |
| Unable to preview $1: SVG root item missing | The SVG file is malformed, lacking the required root element. |
| Unable to preview $1: illegal scripting detected in SVG | The SVG file contains embedded scripts that are disallowed for security reasons. |
| Unable to preview $1: file type not supported | The provided file type is not supported by the preview handler. |
| Unable to preview $2: file type not supported | The media file is of a type that cannot be previewed by the system. |
| Unable to preview $1: $2 | A validation error occurred while attempting to preview the file. |
| Bulk operation failed. Please try again later. | The bulk operation encountered a general failure, possibly due to server issues. |
| Files can only contain normalized, small latin letters, digits and hyphens. This file contains illegal characters: $1 | The file name includes characters that are not permitted. |
| Files can only contain normalized, small latin letters, digits and hyphens. The following files contain illegal characters: $1 | One or more file names include characters that are not permitted. |
| Folders can only contain normalized, small latin letters, digits and hyphens. This folder contains illegal characters: $1 | The folder name includes characters that are not permitted. |
| You need to sign in to generate the preview of more than 100 files | The user is not signed in and has exceeded the preview limit. |
| You need to sign in to publish more than 100 files | The user is not signed in and has exceeded the publication limit. |
| Caution: unexpected side effects! | This warns the user that an action might have unforeseen consequences. |
| Legacy sidekick not found. If the extension is installed but currently disabled, please enable it and try again. | The legacy AEM Sidekick extension is either missing or disabled. |
| This file no longer exists in the repository, deleting it cannot be undone! Are you sure you want to delete it? | The file is missing from the repository, and deletion is irreversible. |
| This page no longer has a source document, deleting it cannot be undone! Are you sure you want to delete it? | The page is missing its source document, and deletion is irreversible. |
| Are you sure you want to $1 this? | This is a generic prompt to confirm a destructive action. |
| Sorry, please enter the text exactly as displayed to confirm. | The entered confirmation text did not match the expected text. |
| Type $1 to confirm | A prompt asking the user to type a specific confirmation string. |
| Too many requests: Your project is being throttled by $1. Please wait and try again later. | The system is rate limiting due to excessive requests. |
| Deletion failed. Please try again later. | The deletion process encountered a server or permission issue. |
| Apologies, we seem to be having problems at the moment. Please try again later. | A general, unexpected internal error occurred on the server. |
| An error occurred: $1 | A catch-all error likely triggered by an unforeseen issue. |
| Job not found. | The specified job identifier does not exist or could not be located. |
| Sign in aborted. | The user or system canceled the sign-in process. |
| Sign in timed out. Please try again later. | The sign-in process took too long—possibly due to network or server overload. |
| Sign out failed. Please try again later. | An error occurred during sign-out, possibly due to session or network issues. |
| Preview generation failed. Please try again later. | The system was unable to generate a preview, possibly because of file or backend issues. |
| Failed to activate configuration: $1 | There was a problem during configuration activation, possibly due to misconfiguration or missing parameters. |
| This is a Microsoft Word document, please convert it to Google Docs first. | The document format isn’t supported directly for preview; conversion is required. |
| This is a Microsoft Excel document, please convert it to Google Sheets first. | The document format isn’t supported directly for preview; conversion is required. |
| Preview generation failed. Must be Google document or spreadsheet. | The file type is not supported for preview; the system expects a Google Doc/Sheet. |
| Publication failed. Please try again later. | The publication process encountered an error, likely due to server or configuration issues. |
| Publication failed, generate preview first. | A preview is required before publication; an intermediate step is missing. |
| Failed to fetch the page status. Please try again later. | The system couldn’t retrieve the current status, possibly due to network or backend issues. |
| Failed to fetch the page status. Make sure this document is being shared with AEM. | The document may not have been shared properly with AEM, causing a lookup failure. |
| Unpublication failed. Please try again later. | An error occurred during the unpublication process, possibly due to server or permission issues. |
See a complete list of all messages in GitHub.