The SpeedSize Shopify app includes an Asset Management section that provides advanced control over theme asset processing.
Using Asset Management, you can review processing status, reprocess assets, restore original files, ignore files from processing, and troubleshoot media detection issues.
This guide covers advanced asset management workflows for the SpeedSize Shopify integration.
This article contains the following topics:
- Asset Management Overview
- Asset Statuses
- Reprocessing Assets
- Restoring Assets
- Ignoring Entire Files
- Ignoring Specific Code Areas
- Ignoring Specific Media URLs
- Improving Media Detection
Asset Management Overview
The Asset Management section displays all scanned theme assets and their current processing status.
From this section, you can review asset processing status, manually reprocess files, restore original files, ignore files from processing, and identify assets requiring attention.
This section is particularly useful when testing integrations, troubleshooting coverage issues, excluding problematic assets, validating theme changes, and debugging dynamic media implementations.
Asset Statuses
Each asset is assigned a processing status that reflects its current state.
| Status | Meaning |
|---|---|
| Processed | The asset has been scanned and processed successfully. SpeedSize modified the file where supported media references were detected. |
| Untouched | The asset was scanned but no supported media references were detected, so no changes were required. |
| Ignored | The asset was excluded from processing manually through Asset Management. |
| Suspended | The asset cannot currently be processed because Shopify rejected the modified file or another issue was detected. |
| Restored | The asset was previously processed and later restored to its original state. |
| Modified | The asset has changed since the last scan and is waiting to be reprocessed automatically. |
| Pending Process | The asset has been scheduled for scanning and processing. |
| Pending Restore | The asset has been scheduled for restoration. |
Note: For config/settings_data.json, the status only indicates whether the file was modified beyond the SpeedSize app settings themselves.
Reprocessing Assets
Assets can be reprocessed manually through Asset Management.
Manual reprocessing may be useful when:
- using Manual Processing Mode
- testing theme changes
- troubleshooting media coverage
- updating media-related Liquid variables
- validating newly added sections or snippets
After reprocessing is triggered, the asset status will update automatically.
Restoring Assets
Processed assets can be restored to their original state individually through Asset Management.
Restoring an asset removes SpeedSize modifications from the selected file while preserving the original Shopify theme logic and media references.
This may be useful when:
- debugging storefront behavior
- testing exclusions
- troubleshooting third-party integrations
- temporarily disabling processing for a specific file
Note: In Automatic Processing Mode, restored files should also be ignored to prevent automatic reprocessing.
Ignoring Entire Files
Entire theme assets can be excluded from processing directly through Asset Management.
Ignored assets will no longer be scanned or modified by SpeedSize.
This may be useful when:
- excluding problematic files
- preventing conflicts with custom implementations
- bypassing unsupported third-party integrations
- excluding intentionally unoptimized assets
Ignored files can later be restored and reprocessed if needed.
Ignoring Specific Code Areas
Specific code areas cannot be excluded through Asset Management directly. These exclusions must be added manually inside the theme code.
Instead of ignoring an entire file, specific sections of code can be excluded from processing. This allows preserving SpeedSize processing for the rest of the asset while excluding only problematic or unneeded code blocks.
Excluding Liquid Code Areas
To exclude part of a Liquid asset, wrap the code block with:
##speedsizeIgnore##... excluded area ...##endSpeedsizeIgnore##
Excluding HTML Code Areas
To exclude HTML-based sections, wrap the code block with:
<!--speedsizeIgnore-->... excluded area ...<!--endSpeedsizeIgnore-->
These exclusions prevent SpeedSize from injecting CDN prefixes inside the wrapped code area.
Ignoring Specific Media URLs
Specific media references can be excluded from processing by adding a speedsizeIgnore marker directly to the media URL.
Example:
<link rel="icon" type="image/png" href="//example.com/icon.png?speedsizeIgnore">or:
<img src="{{ image_url }}?speedsizeIgnore">When the speedsizeIgnore marker is detected, SpeedSize skips processing for that specific media reference while continuing to process the rest of the asset normally.
This may be useful when:
- excluding a single problematic asset
- bypassing unsupported media logic
- preserving custom media handling
- avoiding conflicts with third-party scripts
Improving Media Detection
In some implementations, media URLs may not be detected automatically. This usually happens when media references are stored in variables with unclear or non-descriptive names.
Example:
{% assign abcde = image_url %}To improve detection accuracy, you can:
- add the variable name to the Additional Allowed Liquid Variables setting
- rename the variable so it ends with a meaningful media-related suffix such as
imageUrl,img_url, or_speedsizeDetectable
Example:
{% assign hero_imageUrl = image_url %}After updating the variable, wait for automatic reprocessing or manually trigger reprocessing through Asset Management.