By default, when using our API for uploading, Cloudinary will set a randomly generated public ID for the uploaded image.
You can set the use_filename parameter to true to set the uploaded image's public ID to match the original file's name, normalized, and with some random characters added to the end to ensure uniqueness.
If you want to use the original filename without any additional characters, this is also possible. When setting the use_filename parameter to true you can also set the unique_filename parameter to false and Cloudinary will use the original filename without adding random characters to create a unique public ID.
Here's an example using Cloudinary's Ruby SDK:
Cloudinary::Uploader.upload("my_image.jpg", :use_filename => true, :unique_filename => false)
Note that if you already have an image stored in your account that has that exact public ID, it will be overwritten.
You can also specify those options in an Upload Preset, including an upload preset which will be used when you upload files using our Upload Widget or our Media Library interface. For an example of this, please see our Upload Preset Configuration article.
Comments
12 comments
i think it not really keep the file name as it's current name** if** it has more period(s) other than it's file extension. I've test it today, the period will changed into underscore.
for example : image.name.png=>** image_name**.png
is there any solution to keep it as it is? it's real name with period(s) in it.
In Cloudinary we, indeed, replace periods with underscores as part of our naming conventions. Although, you can by-pass it by either explicitly supply the public_id, e.g., (in rails):
Cloudinary::Uploader.upload(" my.image.jpg", :public_id => "my.image")
Or, post-upload, rename the image using the Media-Library or the API, e.g., (in rails):
Cloudinary::Uploader.rename("my_image","my.image")
oh i see. so i supposed to specifically fill in the public_id with image file name
Did it work for you?
If there is any thing else we can assist you with, please feel free to open a ticket:
http://support.cloudinary.com/tickets/new
UPDATE
The system was just updated to support dot-included filenames, so
use_filenamewill not replace dots with underscores.Hi
I am trying to upload the file keeping the original filename. Please check what I am doing wrong.
echo cl_image_upload_tag('test', array("tags" => "direct_photo_album", "callback" => $cors_location, "html" => array("multiple" => true),"folder" => "my_folder","unique_filename" => false));
I couldn't find the
use_filenameparameter in the code you shared.Please try the following and let me know if this works for you:
echo cl_image_upload_tag('test', array("tags" => "direct_photo_album", "callback" => $cors_location, "html" => array("multiple" => true),"folder" => "my_folder","use_filename" => TRUE, "unique_filename" => FALSE));
Hi Itay
I am using this in my view on RoR
<%= f.attachinary_file_field :file, as: :attachinary, cloudinary: {use_filename: true, unique_filename: false} %>
but it doesn't work. It is always changing the document name. Could you help me please?
For some reason the underscore characters are deleted from my comment.
this is how i have
http://screencast.com/t/PpWmDIgmQ7co
Hi,
Sorry for the very late reply, we have noticed that this request was left unattended. I see that your issue was handled through a support ticket with Itay:)
Hi there, I have the same problem as Mirta reported...
If you guys gave her the solution, could you please also answer it in here to help other people?
Thx!
Hi Luciano,
Please try to reach us at support@cloudinary.com
Best,
Yaki
Please sign in to leave a comment.