All Versions
Latest Version
Avg Release Cycle
118 days
Latest Release
2045 days ago

Changelog History

  • v6.1.0 Changes

    July 27, 2018
    • ๐Ÿ›  BUGFIX: Don't double-encode URLs (Roderick Monje).
    • ๐Ÿ›  BUGFIX: Only use the content_type when it exists (Jean-Philippe Doyle).
    • ๐Ÿ‘ STABILITY: Better handling of the content-disposition header. Now supports file name that is either enclosed or not in double quotes and is case insensitive as per RC6266 grammar (Hasan Kumar, Yves Riel).
    • STABILITY: Change database column type of attachment file size from unsigned 4-byte integer to unsigned 8-byte bigint. The former type limits attachment size to just over 2GB, which can easily be exceeded by a large video file (Laurent Arnoud, Alen Zamanyan).
    • ๐Ÿ‘ STABILITY: Better error message when thumbnail processing errors (Hayden Ball).
    • ๐Ÿ STABILITY: Fix file linking issues around Windows (Akihiko Odaki).
    • STABILITY: Files without an extension will now be checked for spoofing attempts (George Walters II).
    • STABILITY: Manually close Tempfiles when we are done with them (Erkki Eilonen).
  • v6.0.0 Changes

    March 09, 2018

    6.0.0 (2018-03-09):

    • ๐Ÿ‘Œ Improvement: Depend only on aws-sdk-s3 instead of aws-sdk (#2481)
  • v5.3.0 Changes

    March 09, 2018

    5.3.0 (2018-03-09):

    • ๐Ÿ›  Bugfix: Allow paperclip to load in IRB (#2369)
    • ๐Ÿ›  Bugfix: MIME type detection (#2527)
    • ๐Ÿ›  Bugfix: Bad tempfile state after symlink failure (#2540)
    • ๐Ÿ›  Bugfix: Rewind file after Fog bucket creation (#2572)
    • ๐Ÿ‘Œ Improvement: Use FactoryBot instead of FactoryGirl (#2501)
    • ๐Ÿ‘Œ Improvement: README updates (#2411, #2433, #2374, #2417, #2536)
    • ๐Ÿ‘Œ Improvement: Remove Ruby 2.4 deprecation warning (#2401)
    • ๐Ÿ‘Œ Improvement: Rails 5 migration compatibility (#2470)
    • ๐Ÿ‘Œ Improvement: Documentation around post processing (#2381)
    • ๐Ÿ‘Œ Improvement: S3 hostname example documentation (#2379)
    • ๐Ÿ‘Œ Improvement: Use Terrapin instead of Cocaine (#2553)
  • v5.2.1 Changes

    January 27, 2018

    5.2.1 (2018-01-25):

    • ๐Ÿ›  Bugfix: Fix copying files on Windows. (#2532)

    5.2.0 (2018-01-23):

    ๐Ÿ”’ Security: Remove the automatic loading of URI adapters. Some of these
    adapters can be specially crafted to expose your network topology. (#2435)

    ๐Ÿ›  Bugfix: The rake task no longer rescues Exception. (#2476)

    ๐Ÿ›  Bugfix: Handle malformed Content-Disposition headers (#2283)

    ๐Ÿ›  Bugfix: The :only_process option works when passed a lambda again. (#2289)

    Improvement: Added :use_accelerate_endpoint option when using S3 to enable
    โœ… Amazon S3 Transfer Acceleration

    ๐Ÿ‘Œ Improvement: Make the fingerprint digest configurable per attachment. The
    ๐Ÿ”ง default remains MD5. Making this configurable means it can change in a future
    ๐Ÿ”– version because it is not considered secure anymore against intentional file
    ๐Ÿ”’ corruption. For more info, see

    You can change the digest used for an attachment by adding the
    :adapter_options parameter to the has_attached_file options like this:
    has_attached_file :avatar, adapter_options: { hash_digest: Digest::SHA256 }

    ๐Ÿ–จ Use the rake task to regenerate fingerprints with the new digest for a given
    class. Note that this does not check the file integrity using the old
    ๐Ÿ–จ fingerprint. Run the following command to regenerate fingerprints for all
    ๐Ÿ‘‰ User attachments:
    ๐Ÿ–จ CLASS=User rake paperclip:refresh:fingerprints
    You can optionally limit the attachment that will be processed, e.g:
    ๐Ÿ–จ CLASS=User ATTACHMENT=avatar rake paperclip:refresh:fingerprints (#2229)

    ๐Ÿ‘Œ Improvement: The new frame_index option on the thumbnail processor allows
    you to select a specific frame from an animated upload to use as a thumbnail.
    ๐ŸŽ‰ Initial support is for mkv, avi, MP4, mov, MPEG, and GIF. (#2155)

    ๐Ÿ‘Œ Improvement: Instead of copying files, use hard links. This is an
    optimization. (#2120)

    ๐Ÿ›  Improvement: S3 storage option :s3_prefixes_in_alias. (#2287)

    ๐Ÿ‘Œ Improvement: Fog option :fog_public can be a lambda. (#2302)

    ๐Ÿ‘Œ Improvement: One fewer warning on JRuby. (#2352)

  • v5.2.0

    January 23, 2018
  • v5.1.0 Changes

    August 19, 2016
    • Add default content_type_detector to UploadedFileAdapter (#2270)
    • 0๏ธโƒฃ Default S3 protocol to empty string (#2038)
    • Don't write original file if it wasn't reprocessed (#1993)
    • Disallow trailing newlines in regular expressions (#2266)
    • ๐Ÿ‘Œ Support for readbyte in Paperclip attachments (#2034)
    • (port from 4.3) Uri io adapter uses the content-disposition filename (#2250)
    • ๐Ÿ“š General refactors and documentation improvements
  • v5.0.0 Changes

    July 01, 2016
    • ๐Ÿ›  Bugfix: Now it's possible to save images from URLs with special characters [#1932]
    • ๐Ÿ›  Bugfix: Return false when file to copy is not present in cloud storage [#2173]
    • Automatically close file while checking mime type [#2016]
    • โฑ Add read_timeout option to UriAdapter#download_content method [#2232]
    • ๐Ÿ›  Fix a nil error in content type validation matcher [#1910]
    • ๐Ÿ“š Documentation improvements
  • v5.0.0.beta2 Changes

    April 20, 2016
    • ๐Ÿ›  Bugfix: Dynamic fog directory option is now respected
    • ๐Ÿ›  Bugfix: Fixes cocaine duplicated paths [#2169]
    • ๐Ÿš… Removal of dead code (older versions of Rails and AWS SDK)
    • README adjustments
  • v5.0.0.beta1 Changes

    April 20, 2016

    โฌ‡๏ธ Drop support to end-of-life'd ruby 2.0.

    โฌ‡๏ธ Drop support for end-of-life'd Rails 3.2 and 4.1

    โฌ‡๏ธ Drop support for AWS v1

    โœ‚ Remove tests for JRuby and Rubinius from Travis CI (they were failing)

    ๐Ÿ‘Œ Improvement: Add fog_options configuration to send options to fog when
    storing files.

    Extracted repository for locales only:

    ๐Ÿ–จ Bugfix: Original file could be unlinked during post_process_style, producing failures

    ๐Ÿ›  Bugfix for image magick scaling images up

    Memory consumption improvements

    0๏ธโƒฃ url on a unpersisted record returns default_url rather than nil

    ๐Ÿ‘Œ Improvement: aws-sdk v2 support

    If your Gemfile contains aws-sdk (>= 2.0.0) and aws-sdk-v1, paperclip will use
    aws-sdk v2. With aws-sdk v2, S3 storage requires you to set the s3_region.
    s3_region may be nested in s3_credentials, and (if not nested in
    s3_credentials) it may be a Proc.

  • v4.3.7 Changes

    July 01, 2016
    • โž• Add deprecation warnings
    • ๐Ÿ‘Œ Improvement: Add fog_options configuration to send options to fog when storing files
    • ๐Ÿ‘Œ Improvement: the URI adapter now uses the content-disposition header to name the downloaded file