
When a RawTherapee CLI result ignores a requested PP3 value, inspect the entire profile chain. Defaults, explicit profiles and the image's sidecar can all supply that parameter. In particular, the position of -s relative to -p matters; do not assume that a sidecar always loads last regardless of the command.
RawPedia's Command-Line Options, Example 2 demonstrates a sidecar inserted between explicit profiles. The command's processing contract includes that order, not merely the list of filenames.
Write the chain in the order it is meant to apply
Begin with neutral values, include the configured default with -d if required, and then identify the intended explicit-profile and sidecar sequence. Later supplied values can override earlier values for the same parameter.
For a proposed job, a base profile could supply reusable metadata, the source sidecar supply the accepted edit, and a final delivery profile supply output-related processing settings. Those are hypothetical roles; they are not files distributed with this guide.
A readable schematic command is:
rawtherapee-cli -o output -d -p base.pp3 -s -p delivery.pp3 -t -c photo.raw
Replace the executable, paths and profile filenames for the actual installation. Keep -c and its input last, as documented. This example has not been executed and deliberately omits the overwrite option.
Find competing values rather than guessing from the preview
Inspect the particular parameter that differs. If both the image sidecar and delivery profile contain it, identify which appears later in the intended sequence.
A batch adjustment allowlist is useful for keeping a delivery profile narrow. A complete profile used as a small output preset can unintentionally replace far more than output-related settings.
Record the chosen command and profile versions with the proposed output. Reordering a command without preserving that information makes a later comparison ambiguous.
Distinguish a missing sidecar from an overridden sidecar
The documented -s behavior uses an existing sidecar when present. -S additionally skips an image when its sidecar is absent. Choose the policy according to whether processing an image without its accepted settings is allowed.
A batch that produces fewer files under -S is not automatically an export failure. Inspect whether the skipped sources lacked the expected companion file. Conversely, an output produced under -s does not prove that a sidecar existed and supplied the edit.
The RAW-and-sidecar handoff guide explains why an image and its processing instructions are separate resources. RawTherapee requires its own PP3 instructions here, rather than an assumption that any XMP sidecar is interchangeable.
Confirm one conflicting parameter on a disposable input
Use two known profiles with an identifiable competing value, retain the original source, and render to a separate sample destination. Compare the intended order, actual controls represented by the profiles and resulting image.
If no profile supplies the requested value, ordering cannot invent it. If the value is correct but appearance differs, investigate application version and processing conditions separately. Precedence is one reproducibility question, not a guarantee of identical pixels across every environment.
Related tasks
- Which Photo Edits Should I Copy to a Whole Set, and Which Should Stay Individual?
- Why Does My RAW Photo Lose Its Edits on Another Computer?
Sources and scope
- RawPedia: Command-Line Options: Example 2 explicitly says -s position controls when a sidecar loads relative to -p profiles. -d supplies the default base; -S skips inputs without sidecars; -c must be last.
Official RawPedia documentation was opened on October 23, 2026 (Asia/Shanghai). Examples, commands and acceptance procedures are proposed and have not been executed for this guide. Software behavior and paths should be checked against the installed build.
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: Mariya Eskina / Pexels, Pexels License. This is an illustrative source photograph, not an application screenshot or a generated test result.