Skip to main content

Managing Assets in the SpeedSize Shopify App

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

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.

Related articles