File management

Every file you upload in Bloomreach—images, videos, and other assets—lives in one place instead of being scattered across individual campaigns. The Asset manager stores all uploaded files in one shared location. Upload an image, video, or other file once, then reuse it in every place such files are used, including emails, weblayers, and push notifications. You can also organize files into folders.

Access the Asset manager from any campaign or workspace that uses files. Through the asset picker or an image input, you can locate a file and reuse it across multiple campaigns and channels. Insert a file with the Copy URL option, or use Copy HTML in HTML-based campaigns to generate a tag with basic attributes.

Supported file types

The Asset manager supports these file types:

• Images (max 2MB): jpg/jpeg, png, gif, svg, webp
• Videos (max 20MB): mp4, webm, mkv
• Other files (max 5MB): pdf, rtf; MS Office formats (doc, ppt, pps, xls, docx, pptx, ppsx, xlsx); OpenOffice formats (odt, ods, odp); fonts (ttf/otf, woff, woff2); and css

Upload files

To upload a file, go to Asset manager > Files, then click Upload file or drag files into the list. The file uploads into your selected folder, and a pop-up at the bottom of the screen shows upload progress.

Bloomreach stores files in Google-hosted storage with public URLs you can use in campaigns or for custom fonts.

Once uploaded, you can preview a file (except Other type files) and edit it—change its display name, or add tags or a description.

Each file keeps a system-generated ID, used in its public URL, plus an editable, human-readable display name. That name defaults to the original file name and is what you search by.

Bulk actions

You can act on files individually or in bulk, depending on how you select them.

Bulk actions aren't available from the Edit dropdown.

You can also replace an uploaded file with a new version, or fix a relative image path—see Replace uploaded files and Replace image relative paths.

Bulk archive

Bulk archiving works the same way for other asset types—scenarios, weblayers, campaigns, and blocks. Select multiple items, then archive them from the Actions dropdown above the asset list. As with files, you can't bulk-archive from an individual asset's Edit dropdown.

Replace uploaded files

Double-click a file to open its editor, then click Select new file to swap in a replacement and save. The file keeps its original URL, so campaigns already using it automatically show the new version.

The replacement must match the original file type—image for image, video for video, and so on for other types (for example, .css for .css, not .doc for .pdf). Updates can take up to an hour to propagate to the public URL.

To check which campaigns depend on a file, open the three-dot menu in the top-right corner and click Show usages.

Replace image relative paths

HTML email templates built outside Bloomreach sometimes use relative image paths, for example <img src="./name_of_your_image.jpg">. Once you've uploaded the matching files to the Asset manager, use Replace relative paths from the (...) menu to swap them for public URLs automatically, based on a match against file names.

Selecting Replace relative paths opens a modal where you choose the folder containing the matching files. The modal shows how many relative paths it detected and how many it can replace from that folder, and can list them individually if needed. Once you confirm, every relative path matching a file name in that folder is replaced with the public URL—folder paths inside the relative path are ignored, since files are matched by name only.

False positive relative paths

The relative-path lookup can flag false positives—attributes that look like relative paths but aren't. If any are detected, Bloomreach warns you when you click Start on the campaign, so you can confirm it will send correctly. Checking that every path that should be replaced actually was is on you.

Organize files

Click New folder to create a folder in your selected location, keeping files organized. Navigate by double-clicking a folder name or using the breadcrumb above the list or grid view.

Move folders or files into another folder with the Move to folder action, which opens a folder picker for the target location. You can also delete, archive (including all contents), or rename a folder.

Search works by file or folder name, and defaults to your selected folder (shown by a folder icon in the search input). To search everywhere instead, press backspace or clear the folder icon.

Clone files

Clone a file on its own—from its three-dot menu in the Asset manager, or while updating it—or let Bloomreach clone it automatically as a dependency when you clone a campaign.

Cloning copies the file and its folder structure to the target project, then updates campaign links to reference the local copy. Standard conflict-resolution rules apply, same as for any other asset: Duplicate, Replace, or Use existing.

Use files in campaigns

Access your files from a campaign in 2 ways:

1. The + asset picker button at the bottom of the campaign editor or action node modal.
2. An image input's integrated + button.

Either way, the asset picker modal opens directly on Files, or on a combined view that also includes other asset types like blocks and snippets. From there, search for an existing file or upload a new one, then choose one of the following.

Copy HTML

Opens the file preview so you can set attributes for the file type, then generates and copies the resulting HTML to your clipboard.

For image files, set width, height, alt text, and an optional link—this produces an <img> tag, wrapped in an <a> tag if you provide a link.

<a href="https://www.bloomreach.com">
<img src="https://storage.googleapis.com/gqa-app-storage/0699cd30-2997-11eb-a8d0-a6a4141bd2d6/media/original/93b1b736-d7f3-11eb-a598-7685f6020f48" width="500"  alt="logo"/>
</a>

For video files, set width, height, and alt text—this produces a <video> tag.

<video src="https://storage.googleapis.com/gqa-app-storage/0699cd30-2997-11eb-a8d0-a6a4141bd2d6/media/original/ecc96426-xxx-ce5b6df41c5e" width="300" height="auto">Promo video</video>

For other file types, set link text—this produces an <a> tag.

<a href="https://storage.googleapis.com/gqa-app-storage/0699cd30-2997-11eb-a8d0-a6a4141bd2d6/media/original/a1afe5aa-xxx-ced1b740f570">Link text</a>

• Copy URL: Copies the file's URL to your clipboard.
• Select: Inserts the file's URL into the image input field.

Legacy files migration

Previously, images uploaded within the HTML email editor or the Blocks personalization menu were only visible within the specific email template or block where you uploaded them. Bloomreach now migrates all of those images automatically into the central Asset manager.

Migrated files land in folders based on where they came from:

Email campaigns (folder)

• Email campaigns
  • Campaign name_campaign_id (folder): image1, image2, …
• Scenarios
  • Scenario name_scenario_id (folder): image1, image2, …
• Email blocks
  • Block name_block_id (folder): image1, image2, …
• Email templates

For migrated campaigns, an infobox links directly to the folder containing the files.