Logo

Documentation

Shopify App • Media Storage Manager • Cleanup

NexVault helps merchants reclaim storage, optimize media, and keep Shopify files organized. It detects unused/orphaned files, finds duplicates, compresses uploads, and provides safe trash/restore tools.

1. Overview

NexVault is a Shopify media management app designed to reduce storage waste and improve store performance. It provides tools to scan, organize, and optimize your Shopify files while keeping actions safe and reversible.

Supported File Types

  • Images (JPEG, PNG, WebP)
  • Videos
  • Documents (PDF, DOCX, XLSX)

What NexVault Helps You Do

  • Detect unused/orphaned assets
  • Find and remove duplicate media
  • Compress images on upload or in bulk
  • Keep a safe Trash window with restore
Safe by design: Most destructive actions flow through Trash first, giving you time to restore files if needed.

2. Dashboard

The dashboard is your control center—showing storage usage, unused files, duplicates, and the progress of background scans.

Key Metrics

  • Total Storage Used — overall media storage usage
  • Unused / Orphaned Files — files not referenced anywhere
  • Duplicate Files — duplicate groups detected
  • Largest File — the biggest asset currently stored

Media Optimization Score

A quick indicator of how optimized your library is based on saved storage and compression coverage.

Score updates as scans finish
Tip: If you don’t see insights yet, run scans (unused files / duplicates) and refresh the dashboard when tasks complete.
NexVault Dashboard Metrics

3. Files Explorer

The Files page lists all managed Shopify media with previews, usage counts, sizes, and status labels.

ColumnDescription
PreviewThumbnail or quick indicator of the file type.
TypeImage, video, or document.
SizeThe file’s size in KB/MB.
UsageHow many times the file is referenced (0 often implies orphaned).
StatusUsed, Orphaned, or Trash.
Important: Orphaned means “not referenced”, not necessarily “unimportant”. Review before deleting.

Enhanced Visual Comparison

4. Duplicate Finder & Visual Compare View

Duplicate Finder uses perceptual hashing and file signatures to uncover identical or near-identical image files taking up space in your Shopify store. Rather than blindly deleting duplicate candidates, NexVault features an interactive File Compare View that allows merchants to evaluate files side-by-side and explicitly select a master copy.

Comparison Intelligence

  • Exact Matches: Identical byte checksums across different filenames.
  • Perceptual Similarity: Resized, re-exported, or re-compressed variants.
  • Reference Mapping: Detects which products, variants, or blog posts currently reference each copy.

Side-by-Side Features

  • Resolution & Size Tags: Compare pixel dimensions (e.g. 1280 × 698) and weight (KB).
  • Smart Badges: Highlights Highest resolution, Compressed, and Most used.
  • Set as Master: Designate your master file with a single click. NexVault saves this preference and respects it in future scans.
1. Exact Matches Group View

Each duplicate group shows cumulative size, thumbnail preview of the current master, and a direct "Compare files" button to inspect all variants.

Duplicate exact matches list with Compare Files button
2. Side-by-Side File Compare View

Inspect files side-by-side. The currently chosen master is highlighted in green with a Master File (Keeping) label. Any other file can be promoted to master with "Set as master".

Side by side duplicate file comparison view with master selection
Zero Broken References: NexVault inspects whether redundant duplicates have active product or variant links. Redundant copies are safely redirected or reviewed before trashing.

New AI Powered

5. AI Alt-Text Workspace

Descriptive alternative (alt) text improves search engine visibility on Google Images and provides critical accessibility for visually impaired shoppers using screen readers. NexVault's Alt Text Workspace audits your Shopify media catalog and provides both bulk manual and AI-powered text generation.

NexVault Alt Text Workspace interface

Workspace Audit Breakdown

  • Images checked: Total files loaded in the current audit batch.
  • Missing alt text: Assets with completely blank descriptions requiring attention.
  • Existing alt text: Files already populated with alt descriptions (protected by default).
  • Left blank on purpose: Purely decorative background imagery intentionally excluded.

AI & Bulk Workflow

  • Batch Review: Filter by Missing alt text and load files 50 at a time.
  • Character Length Guidance: Adheres to Shopify's recommended 125-character rule (maximum 512).
  • Safe Overwrite Protection: Toggle Allow replacement of existing alt text only when you intend to overwrite existing descriptions.
  • Quota & History: Tracks monthly AI allowance and logs previous batch results.
Best Practice: Keep alt text concise and descriptive of what is visible in the image. Avoid keyword stuffing. NexVault's AI automatically suggests clean, context-rich product descriptions.

New Review • Recover • Resume

6. Failed Job Review & Recovery Hub

When managing thousands of files, external disruptions—such as Shopify API limits, temporary network timeouts, or protected product associations—can occasionally cause a background task to stall. The Failed Job Review page gives store managers complete visibility and granular remediation controls.

NexVault Failed Job Review dashboard

Four Dedicated Diagnostic Tabs

  • File problems: Files that encountered specific blockers during cleanup or optimization.
  • Failed/Cancelled jobs: Background batches that stopped before completion.
  • Webhook retries: Shopify synchronization events queued for retry.
  • Active tasks: Ongoing operations currently executing.

Diagnostic Causes & Action Items

  • Deletion Blocked: Explains when an asset cannot be deleted because product or variant links still exist.
  • Missing fileGid / Fetch Failed: Temporary Shopify GraphQL network issues.
  • One-Click Remedies: Check Shopify status, Refresh indexing, Retry compression, Keep current files, or Delete selected files.
Compression Safety Guard: The page displays your current safety setting (e.g. Keep original disabled/enabled). A retry without a backup replaces the image directly, giving you complete awareness of safety settings.

New Process Control

7. Pause & Resume Background Tasks

NexVault allows merchants to temporarily pause active background processes—including duplicate scans, catalog health analyses, and bulk compression tasks—and resume them at any convenient time.

Pause Anytime

Halt tasks instantly before launching flash sales or when running resource-intensive ERP/product imports.

Seamless Resume

NexVault records the exact file index and checksum state. Resuming continues immediately from the last checkpoint without restarting from zero.

Active Task Status

View processed vs total file counts, elapsed time, and status banners right on the dashboard.


8. Upload & Compression

Upload media through NexVault or run bulk compression on your catalog to dramatically reduce file weights and boost Shopify page speed scores.

Compression Options

  • Quality Slider: Balance visual fidelity with storage savings (recommended 80-85%).
  • Convert PNG → JPEG: Ideal for product photography without transparent backgrounds to save up to 70% space.
  • Convert to WebP: Modern next-gen image format supported across all modern browsers.
  • Max Width Resizing: Scale down massive 4K/5K supplier images to optimal storefront dimensions while preserving aspect ratio.

9. Cleanup (Orphans) & Safe Trash

When products or theme templates are deleted in Shopify, the original media files often remain in storage indefinitely. NexVault's orphan scanner detects unreferenced files and moves them into a safe Trash holding area.

Reversible Holding Window: Files sent to Trash are not deleted permanently right away. You can restore any file with one click during the retention window.

10. Settings & Scheduling

Configure automated scan intervals, compression defaults, notification alerts, and safety thresholds to keep your store running automatically.

Settings Overview
Tip: Enable weekly automated scans and email notifications so NexVault keeps your media library clean in the background without requiring manual intervention.

Frequently Asked Questions

Orphans commonly accumulate after deleting products, replacing images, switching themes, or importing media in bulk. Shopify doesn't automatically delete the associated media when a product is deleted.

NexVault evaluates the visual content of the image and its associated product details to suggest concise, accessible descriptions adhering to Shopify's recommended 125-character rule (max 512). You can preview suggestions, edit them inline, and protect existing descriptions from being replaced unless allowed.

The File Compare View lets you review duplicate versions side-by-side with resolution, size, and detected reference count. Clicking "Set as master" locks your preferred file as the Master File (Keeping). Future scans respect your choice, and NexVault ensures duplicate copies are never trashed without managing their active references.

Inspect the specific reason provided (such as an active product reference or temporary network timeout). From there, you can refresh Shopify indexing, retry compression, keep current files, or safely delete selected files once product references have been resolved.

On any running duplicate scan or bulk compression job, simply click Pause. NexVault saves the exact scanning checkpoint. When ready, click Resume—the job continues from the last processed file without re-scanning or restarting from scratch.