What’s included in the Preservation Hold Library in SharePoint?

Reading Time: 2 minutes

When you publish a Retention Policy to a SharePoint site configured to retain content for a specific period of time, it does its “magic” behind the scenes in a special place called the Preservation Hold Library (PHL). This is well-documented in many locations including the official docs.microsoft.com site, numerous other bloggers’ sites, as well as my own.

This post is not about that, but rather what’s included in the PHL.

I was recently asked a question around what type of content is included in the Preservation Hold library. Does it include only documents (primarily what organizations are interested in and what most posts refer to) or does it also include content stored in other locations across the site?

Great question! In case you were also wondering, here’s a list of the actions done on a site for the common types of content and what, if anything, is placed in the PHL when a retention policy is published to the site (without a conditional apply):

Key to know… retention will apply to ALL libraries and lists on the site including list item attachments, site pages, calendar events, and site assets.

A retention policy configured to delete content after the retention period will NOT delete the home page of a site (good thing!), however it will delete any of the images that may have been placed on pages (including the home page) as the images exist in the Site Assets library in a page-named folder and that library is also under retention.

Retention action

In the table above:

  • if versioning is enabled for a library, ALL versions will be copied to the PHL on document deletion
  • content on the site prior to the Retention Policy being published to it (“Existing” in table) and content added after the Retention Policy was published (“New” in table) behaves differently, thus the distinction

Let me know if you have other types of content you’d like me to test/add/include in the table above.

Thanks for reading.


Credit: Photo by Miguel Á. Padriñán from Pexels


  1. Great info, as alway. Thank you. But what is the difference between “New document is changed” and “Existing document is changed”?

    1. Hi Goran, thank you! Any content on the site prior to the Retention Policy being published to it (“Existing” in table) and content added after the Retention Policy was published (“New” in table) behaves differently, thus the distinction.

  2. Thanks Joanne.Great table. I wonder if this is enough for GPDR . We just created a retention policy for 13 years . I hope this does the trick. Is there a “jump start” Help about this complex subject ? Many thanks .Karen

  3. Great article again.

    One addition is “list item with versioning enabled if deleted” the csv file that gets added to the PHL “only” contains the most recent version and not the version history which is a bit of a shame.

    Given that an individual csv file is added for each deleted list item there is an appropriate place to add the version history as additional rows in the csv.

  4. I’m confused by the new and existing. I ran a test…

    1. Created a new retention policy and pushed it to the site collection.
    2. Waited for the policy to take effect.
    3. Created a new document – no PHL exists.
    4. Edit the document a few dozen times – version count increases, no PHL exists.
    5. Delete the document, PHL is created and I see the deleted document.
    6. Repeat above, incase the existence of PHL is a prerequisite, still no docs in the PHL until they’re deleted.

    I have a customer asking about duplicate storage while a document is active in their doc lib. My testing suggests that the PHL won’t contain documents until they’re deleted, thus saving space.

    Am I missing something?



    P.S. Love your blog series.

    1. Hi Rob,
      I responded via Twitter but this is a longer, more complete answer. If I understand the steps and tests you’ve ran above, you’re running into the scenario I describe in the “In the table above” section… “content on the site prior to the Retention Policy being published to it (“Existing” in table) and content added after the Retention Policy was published (“New” in table) behaves differently, thus the distinction”

      What this means is if you add a new document (which you’ve done) it won’t add anything into the PHL until you delete it. If you have existing documents, it will add entries into the PHL as you edit the document. Does this answer your question? Please suggest a wording change to provide more clarity in the post.
      Thanks for you support!

      1. Thanks Joanne, I believe that helps… in my case I had no existing documents in the site collection before I published the policy. I appreciate you clearing that up for me 🙂

  5. Thanks Joanne for the information.

    Do you know if it is possible to have a retention only on deletion of document and not on change of document ?

    I have a use case where the client don’t want to let document be deleted but want to keep the possibility of moving document. Therefore we can not just remove the deletion persmission because it is required for the move functionnality.

    I tought of Retention but I don’t want to all documents changes to be keep in the PHL, only the deletion.

    Hope it clear. Thank for the help!

    1. Hi Jeff, this is not possible with retention policies. Off the top of my head I don’t know of any way to do what they’re asking.

  6. Thanks for your information Joanne.

    Do you know if it possible to have the documents associated with meta data after deletion of the document and can I restore the document from PHL with all versions and meta data values.

    Let’s assume I’m using document set and deleting the files from one of the document set and would like to restore it from PHL.

    1. Hi Jamie,
      Yes there is. I’m publishing a blog post in about an hour to share the answer.

Leave a Reply to Joanne Klein Cancel reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.