When adding pages to a DocumentPageCollection, this option controls how often the pages get promoted. When set to 0(the default), every time a page is added to a document, the page is promoted. When set to a value other than 0, pages are promoted only after that number of pages is added to the document. For example, when set to 3, pages would only be promoted every time a third page is added to the document.