Asset Library

The Asset Library is your central hub for managing all images and media used across OKeep — menu items, vouchers, promotions, surprise boxes, and more. Upload once, reuse everywhere.

Browsing Your Library

The library displays your assets in a responsive grid that adjusts to your screen size. Each page shows up to 24 assets. Click Load more at the bottom to see additional assets.

Asset Cards

Each asset in the grid shows:

Element	Description
Image preview	A thumbnail of the asset, or a placeholder icon if the image cannot be rendered
Usage count badge	A number showing how many items across OKeep reference this asset
Filename	The original filename of the uploaded image
Size	File size (e.g., 245 KB)
Dimensions	Width and height in pixels (e.g., 1200 x 800)
Tags	The first 3 tags assigned to this asset; additional tags are visible in the detail view

Filtering and Searching

Use the filter bar above the grid to find specific assets:

• Search — type part of a filename to filter the grid instantly
• Tags — open the dropdown to filter by one or more tags; each tag shows a count of how many assets have it
• Clear Filters — reset all active filters to show the full library

Uploading Assets

Single Upload

1. Click Upload Asset in the header
2. Select an image file from your device
3. In the upload modal, configure:
   • Alt Text — a short description of the image (used for accessibility)
   • Tags — add one or more tags to help organize the asset (type a tag name and press Enter to add; click the X on a tag to remove it)
4. Click Upload

The asset appears in the library immediately after upload.

Bulk Upload

To upload multiple images at once:

1. Click Bulk Upload in the header
2. Select multiple image files from your device
3. Assign Tags that will be applied to all uploaded files
4. Click Upload All
5. The modal shows progress and results:
   • Successfully uploaded files are marked with a checkmark
   • If any files fail (e.g., unsupported format, too large), they are shown with an error message
   • Successfully uploaded assets are added to the library even if some files fail

Tip: Bulk upload is ideal when onboarding a new menu. Prepare all your item photos in a folder, upload them together, and tag them with the category name (e.g., "drinks", "desserts") for easy filtering later.

Viewing Asset Details

Click any asset card to open the Asset Detail Modal, which shows full information and management options.

Left Panel

• Image preview — full-size view of the asset
• URL — the asset's hosted URL with a Copy button for quick access

Right Panel

File Information:

Field	Description
Name	Original filename
Size	File size
Dimensions	Width x Height in pixels
MIME Type	File format (e.g., image/jpeg, image/png)

Usage Counts:

The detail view shows exactly where this asset is being used:

Category	What It Counts
Menu Items	Menu items using this image
Vouchers	Voucher templates using this image
Promos	Promo stories using this image
Surprise Boxes	Surprise boxes using this image
Option Groups	Option groups using this image

Alt Text:

Edit the alt text directly in the detail modal. Changes are saved when you close the modal or click away from the field.

Tags:

Add or remove tags from the asset. Type a tag name and press Enter to add. Click the X on any tag to remove it.

Deleting an Asset

1. Open the asset detail modal
2. Click Delete
3. If the asset is currently in use, a warning appears showing where it is referenced
4. You can click Delete Anyway to proceed, but the image will no longer display in those locations

Important: Deleting an asset that is in use will leave blank or placeholder images wherever it was referenced. Check the usage counts before deleting.

Selection Mode and Bulk Actions

For operations on multiple assets at once, use selection mode.

Entering Selection Mode

1. Click Select in the header
2. The grid switches to selection mode — click asset cards to select or deselect them
3. The header updates to show selection controls

Selection Controls

Once in selection mode, the header shows:

Control	Description
Count	Number of currently selected assets (e.g., "3 selected")
Select All	Select all visible assets on the current page
Deselect All	Clear all selections
Add Tag	Open a modal to add a tag to all selected assets
Remove Tags	Open a modal to remove tags from selected assets
Delete	Delete all selected assets (with usage warnings)
Cancel	Exit selection mode without changes

Bulk Add Tag

1. Select the assets you want to tag
2. Click Add Tag
3. Type the tag name (or select from existing tags)
4. Click Apply

The tag is added to all selected assets. Assets that already have this tag are not affected.

Bulk Remove Tags

1. Select the assets you want to modify
2. Click Remove Tags
3. The modal displays all tags that exist across the selected assets
4. Select which tags to remove
5. Click Remove

Only the chosen tags are removed. Other tags on those assets remain untouched.

Bulk Delete

1. Select the assets you want to delete
2. Click Delete
3. If any selected assets are in use, a warning lists them
4. Confirm with Delete Anyway to proceed, or cancel to review

Organizing with Tags

Tags are the primary way to keep your asset library manageable as it grows. Here are practical approaches:

Suggested Tag Structure

Tag Category	Examples	Purpose
Content type	menu, promo, voucher, logo	What the image is used for
Menu category	drinks, mains, desserts, sides	Match your menu structure
Season/event	summer, christmas, valentines	Seasonal promotions
Status	draft, approved, archive	Track image lifecycle

Tag Tips

• Be consistent — decide on a naming convention (lowercase, no spaces) and stick with it
• Use the Tags filter to check what tags already exist before creating new ones
• Bulk tag on upload — assign category tags during bulk upload to avoid tagging later
• Clean up unused tags — when you remove the last asset with a certain tag, the tag disappears automatically

Best Practices

• Upload high-quality images — they look better on all screen sizes and in the customer app
• Use descriptive filenames before uploading (e.g., "grilled-salmon.jpg" instead of "IMG_4521.jpg") since filenames are searchable
• Tag everything — it takes seconds during upload and saves minutes of scrolling later
• Check usage before deleting — the detail modal shows exactly where each asset is referenced
• Use bulk upload when adding many images at once, especially during initial setup
• Review periodically — filter by low usage counts to find assets that might be outdated or replaceable

Next Steps

• Adding Menu Items — use your uploaded assets as menu item images
• Vouchers — attach images to voucher templates
• Promo Stories — use assets in your promotional content