logo
logo

Public links: Updating the master file

When updating the master file of an asset, you must check the existing public links created for the previous master file. If a public link was created from a rendition that is no longer available on the new master file, then the public link for the user rendition fails.

In the following example, we:

  1. Custom download an asset, using a Manual crop, with new rendition name New cropped rendition:

  2. Create a new public link using the New cropped rendition:

  3. Once the public link is created, we can share it with external users:

  4. Upload a new file.

    • This new file becomes the new master file:

    • The renditions are then rebuilt using this new master file. The previously created New cropped rendition is removed and no longer shown in the list of renditions on the Asset details page.

    • However, the public link, created using this now removed rendition, remains:

    • As there is no matching equivalent available, if you selects this public link, then an error message is displayed: Failed Couldn't find the rendition named 'newcroppedrendition_584430cdafb54f61821eb9f8443928a3' on the entity '30218':

    • If an external user views the public link shared with them, they see a 404 error returned.

  5. If you do not require that the public link is available, then you must reset the old file as the master file:

    • Once the older file is reset as master, the renditions are regenerated, and subsequently, the public link is available again.

If the rendition used to create the public link has an equivalent, then there is no issue with a pre-existing public link.

In the following example, we:

  1. Create a public link using the Original rendition:

  2. Once the public link is created, we can share it with external users:

  3. We upload a new file as the master file:

    Because the public link for the old master file uses a rendition that has an equivalent rendition for the new master file, the public link is regenerated and is still valid.

Can we improve this article ? Provide feedback