|
3 | 3 | --- |
4 | 4 | import { Tabs, TabItem } from "~/components" |
5 | 5 |
|
6 | | -Controls amount of invisible metadata (EXIF data) that should be preserved. Color profiles and EXIF rotation are applied to the image even if the metadata is discarded. Note that if the Polish feature is enabled, all metadata may have been removed already and this option will have no effect. |
| 6 | +Controls amount of invisible metadata (EXIF data) that should be preserved. |
| 7 | + |
| 8 | +Color profiles and EXIF rotation are applied to the image even if the metadata is discarded. Content Credentials (C2PA metadata) may be preserved if the [setting is enabled](/images/transform-images/preserve-content-credentials). |
| 9 | + |
| 10 | +Available options are `copyright`, `keep`, and `none`. The default for all JPEG images is `copyright`. WebP and PNG output formats will always discard EXIF metadata. |
7 | 11 |
|
8 | 12 | :::note |
9 | | -Even when choosing to keep EXIF metadata, Cloudflare will modify JFIF data (potentially invalidating it) to avoid the known incompatibility between the two standards. For more details, refer to [JFIF Compatibility](https://en.wikipedia.org/wiki/JPEG_File_Interchange_Format#Compatibility). |
| 13 | +- If Polish is enabled, then all metadata may already be removed and this option will have no effect. |
| 14 | +- Even when choosing to keep EXIF metadata, Cloudflare will modify JFIF data (potentially invalidating it) to avoid the known incompatibility between the two standards. For more details, refer to [JFIF Compatibility](https://en.wikipedia.org/wiki/JPEG_File_Interchange_Format#Compatibility). |
10 | 15 | ::: |
11 | 16 |
|
12 | 17 | Options include: |
13 | 18 |
|
14 | | -* `keep`\ |
15 | | - Preserves most of EXIF metadata, including GPS location if present. |
| 19 | +* `copyright`\ |
| 20 | + Discards all EXIF metadata except copyright tag. |
| 21 | + If C2PA metadata preservation is enabled, then this option will preserve all Content Credentials. |
| 22 | + |
16 | 23 |
|
17 | 24 | <Tabs> |
18 | 25 | <TabItem label="URL format"> |
19 | 26 | ```js |
20 | | - metadata=keep |
| 27 | + metadata=copyright |
21 | 28 | ``` |
22 | 29 | </TabItem> |
23 | 30 | <TabItem label="Workers"> |
24 | 31 | ```js |
25 | | - cf: {image: {metadata: "keep"}} |
| 32 | + cf: {image: {metadata: "copyright"}} |
26 | 33 | ``` |
27 | 34 | </TabItem> |
28 | 35 | </Tabs> |
29 | 36 |
|
30 | | -* `copyright`\ |
31 | | - Discard all metadata except EXIF copyright tag. This is the default behavior for JPEG images. |
| 37 | +* `keep`\ |
| 38 | + Preserves most of EXIF metadata, including GPS location if present. |
| 39 | + If C2PA metadata preservation is enabled, then this option will preserve all Content Credentials. |
32 | 40 |
|
33 | 41 | <Tabs> |
34 | 42 | <TabItem label="URL format"> |
35 | 43 | ```js |
36 | | - metadata=copyright |
| 44 | + metadata=keep |
37 | 45 | ``` |
38 | 46 | </TabItem> |
39 | 47 | <TabItem label="Workers"> |
40 | 48 | ```js |
41 | | - cf: {image: {metadata: "copyright"}} |
| 49 | + cf: {image: {metadata: "keep"}} |
42 | 50 | ``` |
43 | 51 | </TabItem> |
44 | 52 | </Tabs> |
45 | 53 |
|
46 | 54 | * `none`\ |
47 | | - Discard all invisible EXIF metadata. Currently, WebP and PNG output formats always discard metadata. |
| 55 | + Discards all invisible EXIF and C2PA metadata. If the output format is WebP or PNG, then all metadata will be discarded. |
48 | 56 |
|
49 | 57 | <Tabs> |
50 | 58 | <TabItem label="URL format"> |
|
0 commit comments