A file's details

Click a file in the library to preview it in the pane beside the grid, then Details for its type, size, dimensions, upload date and id (Copy id), and what you can change. Changing details takes an admin, developer or editor role in the Space.

The file's own actions are under File actions, next to the dialog's title: opening it or its original, its shares and products, replacing it, and its privacy. A member without an editor role gets the links only: Open file, Open original and Shares.

Title and alt textCopy Anchor Link

Each file has a title and alt text for every language of the Space; pick the language with Language. The Space's languages are the locales set up in Content. Alt text describes the image for people who can't see it; Content's delivery API answers both in the language a site asks for.

Suggest alt textCopy Anchor Link

Suggest alt text, under the alt text in the file's details, asks Obelism to describe an image in the language you are editing. It looks at a smaller copy of the image (private files stay private: the copy never leaves Obelism) and suggests one plain sentence. Keep it puts the suggestion in the alt text field, where you can still change it before you save; Try another asks again; Dismiss drops it. Nothing is saved until you save. It works on JPEG, PNG, GIF, WebP and AVIF images, takes an editor role like changing details, and is limited to 20 suggestions a minute per person. Read the suggestion before you keep it: the model can't know names, brands or places it can't see.

These are the file's own, used wherever it appears. Content can give one use of the file its own alt text instead: see files in Content.

Focal pointCopy Anchor Link

Click the part of the image that crops should keep. Sites get it as focalPoint ({ x, y }, fractions of the width and height from the top left), and Content's image URLs crop around it. Clear removes it: crops then keep the centre.

TagsCopy Anchor Link

Tags are comma separated, up to 20 per file; a longer tag is cut to 40 characters. Tags that differ only in case count as one. They are for finding files again: the tag filter above the library lists them with how many files have each.

Opening and sharingCopy Anchor Link

• Open file opens the copy Content's delivery API serves sites.
• Open original opens the raw file on files.obelism.studio, exactly as uploaded.
• Share makes a link with a password for people outside your Organization; Shares lists the shares that hold the file. See shares.
• Products tags the file with products from the Space's Shopify store. See Shopify.
• Folder, under the texts, moves the file to another folder.

Replacing a fileCopy Anchor Link

Replace file, in the file's details, puts a new file under the same file, so every page using it shows the new one without being edited: a new logo, a corrected PDF.

• The new file must be the same kind: an image for an image, a video for a video.
• Title, alt text, focal point, tags and folder stay. Size and dimensions follow the new file.
• A replacement is at most 50 MB, or 100 MB for a video. Over 25 MB, the library reminds you it adds to your storage quota.
• The file gets new URLs, and the old raw file is deleted. Content's pages using it pick up the new one.

Private filesCopy Anchor Link

Make private keeps a file off public URLs: Content then only serves it with a signed link that lasts a day, handed out by its delivery API. Use it for a members' PDF or a price list.

• Revoke links gives a private file a new signing key: every signed link handed out so far stops working at once.
• Make public serves it without a signature again.

Content's assets guide explains how a site uses private files.

DeletingCopy Anchor Link

Delete removes the file and its stored bytes. It is refused while content still uses the file, in any environment, as a draft or published; the message names what uses it. Remove it from those entries first.