SharePoint Configuration in ReplaceMagic — Complete Settings Guide

All SharePoint-specific settings in ReplaceMagic are located in the Configuration panel under the SharePoint tab. You access it by clicking the Configuration button in the main toolbar. This tab controls metadata preservation, document locking behavior, platform limits, page processing modes, and encoding options. Understanding each setting before you begin a large processing job will help you avoid unexpected results and protect the integrity of your SharePoint environment.

Metadata and Document State Settings

• Keep Last Modified Date and Modified By — After ReplaceMagic uploads a modified file, it restores the original last-modified timestamp and the name of the original editor. This setting requires Site Administrator rights on the target site collection. Without those rights, SharePoint will record ReplaceMagic’s service account as the last editor and set the modification time to now.
• Check-out / Check-in Documents — ReplaceMagic automatically checks out a document before downloading it and checks it back in after uploading the modified version. This ensures that other users cannot modify the file during processing and that SharePoint registers the change as a proper new version.
• Enforce Check-in — When enabled, ReplaceMagic will force-check-in documents that are currently checked out by another user. Use this option with caution: it discards any pending changes the other user has not yet checked in. It is most appropriate in automated migration scenarios where the library is known to be idle.
• Keep Content Approval Status — If a library uses content approval, this setting restores the document’s original Approved, Rejected, or Pending status after processing. Without this option, an approved document may revert to Pending after modification.
• Keep Published Status — Maintains the major/minor version visibility of each document. A document that was published as a major version before processing will remain published after ReplaceMagic completes its work.
• Set Versioning — Controls how ReplaceMagic interacts with the SharePoint versioning system when checking documents back in. Enable to ensure that each processed document is properly tracked in the version history.

Query and Limit Settings

• Query Row Check — Sets the maximum number of items retrieved per SharePoint list query. The default is 4,900 and the maximum is 5,000, which matches SharePoint’s list view threshold. Exceeding 5,000 items in a single query causes SharePoint to return a threshold error. The 4,900 default provides a safe margin below that limit. Adjust only if you have specific reasons to do so.
• Max Doc ID Value — The maximum SharePoint document ID that ReplaceMagic will attempt to retrieve when resolving ID-based links. The default is 30,000,000, which aligns with SharePoint’s internal maximum. Increase this value only if your tenant has unusually high document ID ranges.

Library and Page Scope Settings

• All SharePoint Libraries — When enabled, ReplaceMagic accesses hidden system libraries and ASPX page content in addition to standard document libraries. This mode is powerful but should be used with caution, as it exposes SharePoint system files that are not normally visible to end users.
• Process List Items — Enables URL replacement in SharePoint list item fields (not just document files). Useful when list columns store hyperlinks or file paths that need to be updated.
• Quick Launch and Top Nav Bar — When enabled, ReplaceMagic also updates URLs embedded in the SharePoint site’s Quick Launch navigation panel and the Top Navigation bar. This is especially useful after a tenant-to-tenant migration where navigation links point to the old tenant URL.

Encoding and Legacy Settings

• HTML Decode/Encode SharePoint Pages — For Enterprise Wiki pages that store HTML-encoded content, this option decodes the content before processing and re-encodes it afterward. Required for certain legacy Wiki page formats where special characters are stored as HTML entities.
• Unicode Decode/Encode SharePoint Pages — Applies Unicode normalization when reading and writing SharePoint page content. Enable this when page content contains Unicode escape sequences that must be preserved correctly.
• SharePoint Legacy Auth Mode — Switches the authentication handshake to a legacy mode compatible with forms-based or basic authentication on older on-premises SharePoint farms. Has no effect on SharePoint Online.
• Native SharePoint Check of Broken Links — Performs an in-situ broken link check using the SharePoint API rather than downloading files. This method is significantly slower than ReplaceMagic’s standard file-based check and is not recommended for large libraries. Use only when file-based checking is not suitable for a specific scenario.
• Process All Skipped Documents — Forces ReplaceMagic to reprocess documents that were skipped in a previous run due to specific error codes. Use this after resolving the underlying issue (for example, after granting additional permissions) to pick up documents that were not handled in the initial pass.

Recommended Settings by Scenario

• SharePoint Online migration: Enable Keep Last Modified Date and Modified By, Check-out/Check-in, Keep Content Approval Status, Keep Published Status. Set parallel threads to 3–5.
• On-premises to SharePoint Online: Same as above; additionally enable Quick Launch and Top Nav Bar if navigation links need updating.
• Tenant-to-tenant migration: Enable all metadata preservation options; enable Process List Items and Quick Launch/Top Nav Bar; confirm Max Doc ID is set high enough to cover all ID-based links in the source tenant.