--- title: "Edit and tag photos" slug: "edit-and-tag-photos" updated: 2025-09-16T15:45:32Z published: 2025-10-03T07:52:57Z --- > ## Documentation Index > Fetch the complete documentation index at: https://documentation.deltatre.com/llms.txt > Use this file to discover all available pages before exploring further. # Edit and tag photos In this article, we cover how to manage photos. --- ## Editorial workflow Photos are published or unpublished in all languages, but editors can select ‌visibility per language. E.g., a published photo can be visible in the front-end in English but not in French. Find more details in [Translations with language-independent workflow](/v1/docs/translations-with-language-independent-workflow). ## Upload photos Editors can upload new documents from the document overview page in two ways: - Select *Upload* in the top-right​ corner: ![](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/image-1757952273635.png) - Drag and drop the document file into the documents area: ![](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/image-1757952292251.png) Once uploaded, select the document you want to edit. ### Image metadata mapping to photo fields In *Administration -> Configurations ->* Photo, administrators can map the image metadata to photo fields. E.g., in the screenshot below, - The image's *Title* maps to the photo's *title*. - The image's *ColorSpace* maps to the custom field *colorspace*. ![](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/image-1757952312474.png) When uploading an image for the first time, FORGE creates the photo entity and values its fields accordingly to the configured mapping. ## Edit Photos The photo editor page provides editors with dedicated sessions to manage: - [Translations](/v1/docs/upload-and-manage-documents#h_01JE8G27RT9BG2W44FHJJWAB8C) - [Preview](/v1/docs/upload-and-manage-documents#h_01JE8G27RTY2GXH0K9W5FAMZEE) - [Replace the image](/v1/docs/edit-and-tag-photos#replace-the-image) - [Adjust the focus](/v1/docs/edit-and-tag-photos#adjust-the-focus) - [Full screen](/v1/docs/edit-and-tag-photos#full-screen) - [Main properties](/v1/docs/upload-and-manage-documents#h_01JE8G27RTA0WD24GC7CF0B2QC) - [History](/v1/docs/upload-and-manage-documents#h_01JE8G27RTCAK3RTKR1SA5KNS5) - [General settings](/v1/docs/upload-and-manage-documents#h_01JE8G27RT2PM7V99HHHHVPASG) - [Context and tags](/v1/docs/upload-and-manage-documents#h_01JE8G27RT574DHW9RPDYS19WX) - [Promotion](/v1/docs/upload-and-manage-documents#h_01JE8G27RTQ28EPW62TE8T4C0X) - [Relations](/v1/docs/upload-and-manage-documents#h_01JE8G27RTCYJQAXDKDJQ6K60M) ![](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/image-1757952333889.png) ### Translations ![](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/17546860150172.png) #### Visibility per language By default, photos are visible in all languages. In the translation section, edit the photo visibility language by language. ![](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/18980375991964.png) #### Photo per language Select a language to overwrite the neutral version of the photo properties per language. E.g., in the screenshot below, for the Italian language, the *alpha-plater-it* slug overwrites the neutral *alpha-player*: ![](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/17546860153628.png) ### Preview In the preview section, editors can preview, replace the image, adjust the focus, and see the image full-screen. #### Replace the image Select *Replace image* to change the photo's image: ![](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/18980365365020.png) ... > [!NOTE] > **Note:**When you replace the image in a photo, > > - The photo either goes to *Reviewed* or it is automatically published based on the toggle *Auto publish after replace* in *Administration -> Configurations -> Photo*: ![](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/image(102).png) > - The mapping described in [Image metadata mapping to photo fields](/docs/edit-and-tag-photos#h_01JE982K531AMYW471W9J500BB) isn't applied. So, all photo fields remain valued as they are. #### Adjust the focus Select *Adjust focus* to enter into the *Adjust focus* page: ![](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/18980375993756.png) Then, define the image area that any format must display: ![](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/17546869091612.png) Eventually, select *Apply* in the bottom-right corner to update formats: ![](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/17546869093532.png) Select *Reset focus to default* to delete changes. Otherwise, exit from the *Adjust focus* page by selecting the cross in the top-right corner. Back to the photo editor page, a blue badge near *Adjust focus* highlights that the default focus was changed: ![](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/18980365367836.png) #### Full screen Select *Full screen* to display the image in full resolution in a new browser tab: ![](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/18980365369244.png) ### Main properties ![](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/17546869098012.png) Photo built-in main properties are: - **Entity** code: Read-only unique entity identifier. - **Slug**: Human-readable entity identifier. If the photo isn't published, editors can edit it. - **Content date**: By default, it's the publishing date. Editors can edit it. - **Storage path**: Read-only relative path of the image file location and name in FORGE. - **Original filename**: Read-only name of the uploaded image. ![](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/18980365370396.png) ### History ![](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/17546869099548.png) Like for any entity, this section lists for each change who, what, and when. ### General settings ![](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/17546860169116.png) Editors can select: - **Authorization group**: Select the authorization group that editors must have to edit the photo. - **List availability**: Select whether the photo must be included into lists that the front-end queries. See [List Availability](/v1/docs/list-availability) for more information. ### Context and tags ![](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/17546869106204.png) Editors can select: - **Context**: Text that appears above an article on the front-end. It's a small, but important piece of text which highlights the key features of the content. - **Tags**: Photo's taxonomy. ### Promotion ![](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/17546860170652.png) Editors can promote the photo's visibility by leveraging: - **Feature the content**: Flag that makes a photo featured. This flag informs the front-end that the photo's visibility has a higher priority than not-featured ones. - **Add to selections**: Add the photo to one or many editorial selections. ### Relations ![](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/17546860173596.png) Editors can relate the photo to other entities regardless of their type.