
Use digiKam's Additional sidecar file extensions setting when a photo-management operation must account for companion files such as RawTherapee PP3 profiles. The setting is independent of the normal XMP sidecar controls. Recognizing a PP3 as a companion also does not mean digiKam can interpret or recreate the RawTherapee edit.
The Sidecars section of Metadata Settings describes additional extensions as hidden companions regarded as an extension of the main item.
Inventory the actual pair before configuring the extension
Find the image and its PP3 on disk. Record their complete filenames, including the source extension, and confirm which profile is actually used by RawTherapee.
RawTherapee's processing-profile documentation describes a default source companion such as photo.raw.pp3. The digiKam manual gives its own companion examples. Do not assume a match merely because both filenames end in pp3; inspect the particular naming pattern in the installed workflow.
This is especially relevant when the folder contains both a source profile and an output-associated profile. Moving whichever PP3 is easiest to see may preserve a different set of settings.
Add the companion type separately from XMP
Open Settings > Configure digiKam > Metadata and inspect the Sidecars tab. Add pp3 to Additional sidecar file extensions using the documented extension-list format.
Keep the XMP read/write configuration as a separate decision. Changing XMP filename compatibility does not create a RawTherapee processing profile, and writing captions into XMP does not translate the RAW-development parameters.
The RAW edit handoff guide explains why a source and its application instructions need explicit packaging. A recognized companion remains application-specific data.
Rehearse the intended file operation on a disposable pair
Use a copied source/profile pair in a small test collection. Perform only the file-management operation you actually plan to use, then inspect both the image and companion in the destination.
Because the extra sidecar can be hidden in digiKam's main item display, use the filesystem as part of that check. One moved thumbnail does not establish that its processing instructions followed.
Open the destination image in RawTherapee and inspect the expected settings. This proposed acceptance step tests the exact pair and operation; it is not a claim that every renaming or transfer route in every version has been verified.
Preserve the selected edit, not just any companion
For an accepted interpretation, record which source/profile pair is approved. The version handoff guide helps keep that identity separate from a list of files sharing the same stem.
If the companion does not follow, stop before applying the operation to the archive. Check the naming pattern, extension configuration and operation support rather than deleting the original pair or manually renaming hundreds of profiles.
The intended result is an intact usable association. A copied text file with a familiar extension is not enough if the receiving RAW processor cannot associate it with the right source.
Related tasks
- Why Does My RAW Photo Lose Its Edits on Another Computer?
- How Do I Keep the Approved AI Image or Video from Getting Lost Among Revisions?
Sources and scope
- digiKam Manual: Metadata Settings: Lazy synchronization defers file writes. Reading sidecars can ignore embedded metadata. Sidecar naming, extra extensions, ExifTool backend and RAW-write settings are distinct options.
- RawPedia: Sidecar Files - Processing Profiles: RawTherapee defaults to a source companion such as kitty.raw.pp3; output-associated profiles are separate. The actual naming association must be tested with digiKam companion handling.
The official digiKam 9.2.0 manual was opened on October 23, 2026 (Asia/Shanghai). These are documentation-based instructions with proposed examples and acceptance checks, not hands-on test results. Check controls and file associations against the installed application version.
Prepared by Imagild Editorial, the company editorial team responsible for these guides. AI assisted research and drafting. This is documentation-based guidance with proposed examples, not a claim of hands-on testing or an independent product review. Report a correction.
Cover: William Liu / Pexels, Pexels License. This is an illustrative source photograph, not an application screenshot or a generated test result.