Skip to content

Documentation

Importing and exporting

Exporting gives you a portable copy of selected Akurium collections. Importing can restore an Akurium package or bring it into another account while preserving its catalog structure.

Import and export availability depends on your plan. Visit Plans for the current comparison.

Open your account menu, select Account & Settings, and expand Export / Import.

The section contains two separate tools:

  • Export Collections creates a downloadable JSON file or ZIP package.
  • Import JSON or ZIP reads a package previously created by Akurium.

Select Export Collections, then choose one or more collections. All of your collections are selected by default; use Select all or Deselect all to adjust the list quickly.

Choose whether to include images:

  • With Include images turned off, Akurium downloads akurium-export.json. It contains structured catalog data and references to image paths, but not the image files themselves.
  • With Include images turned on, Akurium creates a ZIP package containing akurium-export.json plus available collection covers and item gallery images.

The structured export includes the selected collections and their items, along with relevant themes, categories, attribute definitions and values, visibility, status, audience classifications, favorites, and following information.

Use the ZIP option when preserving photographs matters. A JSON-only export is useful for catalog data, but it cannot independently restore image files that are no longer available to Akurium.

An export may contain private or unpublished collection information. Treat the downloaded file as personal data even though it does not include your password.

Useful backup habits include:

  • Keep exports in a location you control.
  • Use the date in the filename or containing folder.
  • Keep more than one generation instead of continually replacing the same file.
  • Open ZIP packages occasionally and confirm that they contain akurium-export.json and an assets directory.
  • Create a fresh export before a large import, account cleanup, or plan downgrade.

In Account & Settings, expand Export / Import and upload either:

  • An akurium-export.json file created by Akurium, or
  • An Akurium ZIP package containing the JSON file and bundled images

After Akurium reads the package, select the collections you want to import. All collections in the package are selected by default.

The preview summarizes themes, categories, attribute groups, definitions, collections, items, favorites, follows, and important warnings. Review warnings before continuing.

The import actions include Preserve slugs. Slugs are the URL-friendly identifiers derived from names.

Enable this option when retaining the original slug matters. If it conflicts with an existing record, Akurium can append a number to avoid a duplicate. Leave it off when you are comfortable allowing Akurium to resolve imported slugs for the destination account.

When the preview looks correct:

  1. Confirm the collections selected for import.
  2. Choose whether to preserve slugs.
  3. Select Run import.
  4. Confirm the action.
  5. Read the completion summary and any warnings.

Imported collections and items are set to Draft, including records that were published in the source package. This gives you a chance to review names, images, attributes, audience settings, and visibility before making anything public.

Akurium uses stable identifiers in its export packages to recognize material it has seen before. When a matching collection or item already exists, an import may update it rather than creating a duplicate.

Always preview a repeated import. Create a fresh export first when the destination account contains changes you cannot easily recreate.

Your current plan limits are enforced during import:

  • Collections beyond your available collection limit, along with their associated items, may be skipped.
  • Item limits can cause imported items to be restored as metadata-only drafts without their images.
  • Images beyond the per-item limit may be skipped.
  • Missing files in an image package produce warnings and may leave affected images unavailable.

Import warnings identify these conditions. A completed import can therefore contain fewer collections, items, or images than the source package when the destination plan has lower limits.

After importing, open Manage Your Collections and inspect each imported collection before publishing it. Pay particular attention to:

  • Collection and item visibility
  • The required item audience setting
  • Cover and gallery images
  • Item attributes
  • Names and URLs
  • Warnings reported during preview or import

Publishing remains a separate, deliberate step after the import is complete.