Copy Objects
Learn how to copy and move objects
Copy objects
You can copy objects between buckets or within the same bucket. Currently only objects up to 5 GB can be copied using the API.
When making a copy of an object, the owner of the new object will be the user who initiated the copy operation.
Copying objects within the same bucket
To copy an object within the same bucket, use the copy
method.
_10await supabase.storage.from('avatars').copy('public/avatar1.png', 'private/avatar2.png')
Copying objects across buckets
To copy an object across buckets, use the copy
method and specify the destination bucket.
_10await supabase.storage.from('avatars').copy('public/avatar1.png', 'private/avatar2.png', {_10 destinationBucket: 'avatars2',_10})
Move objects
You can move objects between buckets or within the same bucket. Currently only objects up to 5GB can be moved using the API.
When moving an object, the owner of the new object will be the user who initiated the move operation. Once the object is moved, the original object will no longer exist.
Moving objects within the same bucket
To move an object within the same bucket, you can use the move
method.
_10const { data, error } = await supabase.storage_10 .from('avatars')_10 .move('public/avatar1.png', 'private/avatar2.png')
Moving objects across buckets
To move an object across buckets, use the move
method and specify the destination bucket.
_10await supabase.storage.from('avatars').move('public/avatar1.png', 'private/avatar2.png', {_10 destinationBucket: 'avatars2',_10})
Permissions
For a user to move and copy objects, they need select
permission on the source object and insert
permission on the destination object. For example:
_15create policy "User can select their own objects (in any buckets)"_15on storage.objects_15for select_15to authenticated_15using (_15 owner_id = (select auth.uid())_15);_15_15create policy "User can upload in their own folders (in any buckets)"_15on storage.objects_15for insert_15to authenticated_15with check (_15 (storage.folder(name))[1] = (select auth.uid())_15);