This is the documentation for v3 but the latest version is v10 . You can switch versions in the menu at the top. Check your current version with the following command:

composer show spatie/laravel-medialibrary

Adding files

On this page

  1. Starting methods
  2. Middle methods
  3. Finishing methods

Adding a file to the medialibrary is easy. Just pick one of the starting methods, optionally add some of the middle methods and finish with a finishing method. All start and middle methods are chainable.

For example:

$yourModel
    ->addMedia($pathToFile) //starting method
    ->withCustomProperties(['mime-type' => 'image/jpeg']) //middle method
    ->preservingOriginal() //middle method
    ->toMediaLibrary(); //finishing method

/**
 * Add a file to the medialibrary. The file will be removed from
 * its original location.
 *
 * @param string|\Symfony\Component\HttpFoundation\File\UploadedFile $file
 *
 * @return \Spatie\MediaLibrary\FileAdder\FileAdder
 */
public function addMedia($file)

/**
 * Add a remote file to the medialibrary.
 * 
 * @param $url
 *
 * @return mixed
 *
 * @throws \Spatie\MediaLibrary\Exceptions\UrlCouldNotBeOpened
 */
public function addMediaFromUrl($url)

/**
 * Copy a file to the medialibrary.
 *
 * @param string|\Symfony\Component\HttpFoundation\File\UploadedFile $file
 *
 * @return \Spatie\MediaLibrary\FileAdder\FileAdder
 */
public function copyMedia($file)

/**
 * When adding the file the medialibrary, the original file
 * will be preserved.
 *
 * @return $this
 */
public function preservingOriginal()

/**
 * Set the name of the media object.
 *
 * @param $name
 *
 * @return $this
 */
public function usingName($name)

This is an alias for usingName

/**
 * Set the name of the file that is stored on disk.
 *
 * @param $fileName
 *
 * @return $this
 */
public function usingFileName($fileName)

This is an alias for usingFileName

/**
 * Set the metadata.
 *
 * @param array $customProperties
 *
 * @return $this
 */
public function withCustomProperties(array $customProperties)

/**
 * Set the target media collection to default.
 * Will also start the import process.
 *
 * @param string $collectionName
 * @param string $diskName
 *
 * @return Media
 *
 * @throws FileDoesNotExist
 * @throws FileTooBig
 */
public function toMediaLibrary($collectionName = 'default', $diskName = ''

This is an alias for toMediaLibrary

This is an alias for toMediaLibrary

This is an alias for toMediaLibrary