You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/collections/docs/assets.md
+97-2Lines changed: 97 additions & 2 deletions
Original file line number
Diff line number
Diff line change
@@ -24,13 +24,108 @@ Statamic scans the files in each container and caches [meta information](#metada
24
24
25
25
## Asset Browser
26
26
27
-
You can explore these files in the Control Panel's asset browser. You can file, sort, search, move, rename, preview, and — if working with images — even set focal crop points to make dynamically resized images look their best.
27
+
You can explore these files in the Control Panel's asset browser. You can edit, sort, search, move, rename, replace, reupload, preview, and — if working with images — even set focal crop points to make dynamically resized images look their best.
There are a number of actions that can be taken on assets while in the asset browser. Some can be run in bulk (on multiple assets at once), while others are only available on individual assets.
37
+
38
+
Single asset actions are available by clicking the options menu (three-dot icon) associated with the asset, and picking the desired action from the dropdown list.
39
+
40
+
Bulk asset actions are available at the top of the asset browser whenever you have one or more assets selected.
<figcaption>Check out those sweet actions.</figcaption>
45
+
</figure>
46
+
47
+
### Edit
48
+
Editing an asset opens a new modal window with a number of additional options, as well as any blueprint fields, like title, alt text, description, or other meta data defined on your asset container.
49
+
50
+
Most of the asset actions are also available inside the editor, along with the ability to set a Focal Point for images.
<figcaption>The asset editor is pretty slick, if we say so ourselves.</figcaption>
55
+
</figure>
56
+
57
+
### Copy URL
58
+
Running this action allows you to copy the URL of an asset. You can use the copied URL to share or reference the asset in other places, such as in emails, documents, or on other websites.
59
+
60
+
<dl>
61
+
<dt>Bulk</dt>
62
+
<dd>No</dd>
63
+
</dl>
64
+
65
+
### Download
66
+
With this action, you can download an asset to your local device. It allows you to save a copy of the asset on your computer, making it accessible even when you're offline or outside Statamic.
67
+
68
+
<dl>
69
+
<dt>Bulk</dt>
70
+
<dd>Yes</dd>
71
+
</dl>
72
+
73
+
### Duplicate
74
+
The duplicate action creates a copy of an asset. It's useful when you want to have multiple copies of the same asset, either for organizational purposes or to make variations or modifications to the duplicated version without affecting the original asset.
75
+
76
+
When duplicated, the new filename will be appended with `-{numberOfDuplicates}`. If you duplicate a file 3 times, you will have new copies named `yourFile-1.ext`, `yourFile-2.ext`, `yourFile-3.ext`. Feel free to rename these. In fact, we encourage it.
77
+
78
+
<dl>
79
+
<dt>Bulk</dt>
80
+
<dd>Yes</dd>
81
+
</dl>
82
+
83
+
### Move
84
+
Moving an asset involves changing its location within the folder structure of your Statamic assets. This action is handy when you want to reorganize your assets or place them in a different folder for better categorization and management.
85
+
86
+
Assets moved with the move action will update any references to it throughout your content wherever the [Assets field](/fieldtypes/assets) is used.
87
+
88
+
<dl>
89
+
<dt>Bulk</dt>
90
+
<dd>Yes</dd>
91
+
</dl>
92
+
93
+
### Rename
94
+
As the name suggests, the rename action allows you to change the name of an asset. It's useful when you want to give a more descriptive or meaningful name to an asset or when you need to update the name to match changes in its content.
95
+
96
+
Assets renamed with the rename action will update any references to it throughout your content wherever the [Assets field](/fieldtypes/assets) is used.
97
+
98
+
<dl>
99
+
<dt>Bulk</dt>
100
+
<dd>Yes*</dd>
101
+
</dl>
102
+
103
+
_*Each rename action only accepts one new filename, so this is only useful in bulk for renaming files of different extensions._
104
+
105
+
### Replace
106
+
The replace action lets you replace an existing asset with a new version with a new filename. This helps to ensure that your visitors don't run into browser-cached, old versions of your assets. Replaced assets with the replace action will update any references to it throughout your content wherever the [Assets field](/fieldtypes/assets) is used.
107
+
108
+
<dl>
109
+
<dt>Bulk</dt>
110
+
<dd>No</dd>
111
+
</dl>
112
+
113
+
### Reupload
114
+
Reuploading an asset involves uploading a new version of an existing asset, effectively replacing the previous version with the **same exact filename**. Keep in mind that by not changing the filename, your visitors may encounter browser-cached, old versions of the asset.
115
+
116
+
<dl>
117
+
<dt>Bulk</dt>
118
+
<dd>No</dd>
119
+
</dl>
120
+
121
+
### Delete
122
+
The delete action removes an asset from your site and server, permanently. Exercise caution when using this action, as deleted assets cannot always be easily restored.
123
+
124
+
<dl>
125
+
<dt>Bulk</dt>
126
+
<dd>Yes</dd>
127
+
</dl>
128
+
34
129
## Asset Fields
35
130
36
131
Asset fields are configured like a [blueprint](/blueprints) and attached to the [container](#containers). Whenever you edit an asset in the Control Panel, you'll see the fields from the configured blueprint.
0 commit comments