New in version 2026.3.0.0 (6th of November, 2026)
SmartMapper
- Clearer last page of the SmartMapper wizard. The page Search & replace keys created now starts with a summary of the result: the number of Search & Replace keys and of documents with keys of the run (and the coverage, if the keys were created in this session). The choice of the documents to process is listed one option under the other, each with a short description, and Only documents with SmartMapper keys is marked as the fastest choice. It works on a scan of the source as well as on a scan of the target location.
- Additional runs for ID-based links. SmartMapper can now resolve ID-based links whose target document was scanned in a different run. This covers sharing links, Document ID links (DocIdRedir.aspx?ID=) and sourcedoc links. Previously these links were resolved only if the target was scanned in the same run; otherwise they were reported as unresolved (e.g. SharingTokenUnresolved or IDMatchNotFound). This mainly helps migrations where each site is scanned as its own run.
- New wizard step "Additional runs for ID-based links resolution". It appears after the source run selection when the selected run was scanned on SharePoint. Select the other SharePoint scanning runs that SmartMapper should also search when resolving ID-based links. The keys, mapping rules and results still belong to the selected run.
- Multi-select and Select all. Select several runs with Ctrl/Shift+click, or use Select all / Clear selection.
- Optional. If no additional runs are selected, SmartMapper works exactly as before.
- Remembered selection. Your selection is kept when you move back and forth in the wizard. If you choose a different source run, the selection is cleared.
- Command-line / silent runs. The Command Line Parameters form now has an Additional runs list with a Check All option, instead of a free-text field. The selected runs are saved to the XML configuration, e.g. <SMARTMAPPERADDITIONALRUNS>6,7,8</SMARTMAPPERADDITIONALRUNS>.
- Traceability. For each resolved ID-based link, the Resolved Links view and export show which run the target document was found in (column IdSourceRunID).
- Processing order: additional runs are processed from the latest to the oldest.
- Sharing links are decoded. Current SharePoint sharing links (e.g. https://tenant.sharepoint.com/:w:/s/site/IQ...) contain the ID of the target document. SmartMapper now reads that ID, so these links can be resolved even when the scan did not capture the sharing link itself. Such links are shown with the resolution method ShareTokenDecode. Sharing links in the older format (the token after the site name starts with "E") are still resolved only when the scan captured that sharing link.
- Extended support for UniqueID and GUID based links.
- Links shared with "Can review" and "Can't download" are converted; Unresolved Links show the file name of the document containing the link.
- Links relative to the root of a drive or share are converted. Excel and Word store a link to a file on the same drive as, for example, \Finance\Reports\Budget.xlsx, without the drive letter. SmartMapper now resolves such links against the drive or network share of the document that contains them and converts them with your migration rules. Previously they were reported as RootRelativeUnresolved and left unchanged. This is done only when the target was part of the scan, so links that really point to the root of a web site are still left alone. On a customer scan of 1.1 million documents this converted 44,491 additional links.
- Links that start with the scanned folder are changed even if their target no longer exists. A link to a file on the same drive is often saved without the drive letter (for example \Finance\Reports\Old folder\Book.xlsx). SmartMapper changed such a link only when its folder was found in the scan. Now it is also changed when the link starts with the folder you scanned (for example \Finance when you scanned Z:\Finance), exactly like the same link written with the drive letter (Z:\Finance\...). The file it points to was usually already missing before the migration, so the new link points to the place where it would be after the migration. Links that do not start with the scanned folder (web pages, other folders of the drive) are not changed, as before.
- SmartMapper keys of type Relative no longer change part of another link. A Relative key (for example Picard/Book.xlsx) was also applied inside a longer link of the same document that ends with the same text (for example /Finance/March/Picard/Book.xlsx), which produced a link with two paths glued together. Relative keys are now applied only to a link that starts with them, in the same way as same-folder links. Both kinds of keys are also no longer applied after "@" or ":" (for example inside mailto: addresses or C:\... paths) or to a file name that follows a folder path in the same link (for example a pivot table source read from SharePoint). Absolute keys are not affected.
- "Formulas (Excel)" is no longer used for a SmartMapper replacement. With Formulas (Excel) selected in the Search & Replace options, the SmartMapper keys were also applied to cell formulas. A formula that uses another workbook already shows the changed link source, so the same key could be applied to it a second time and Excel got an additional link with the path twice (for example https://.../Folder/https://.../Folder/Book.xls). While SmartMapper keys are used, Formulas (Excel) can no longer be selected; if it was already selected, ReplaceMagic de-selects it after the SmartMapper wizard and shows a message - all before the replacement starts. In a command-line (silent) run the option is switched off right after the XML file is read and this is written to the log (the XML file is not changed). Links to other workbooks are changed by Link Sources and the formulas follow them. Search & Replace without SmartMapper keys is not affected.
- SmartMapper checks your migration rules before it creates the keys. The log now contains a "Mapping rules check" section. It shows where each scanned folder ends up in the target, and warns about rules that are not used, rules that send links outside the scanned folders or local paths such as C:\Users to SharePoint, and other drives or shares that point to the same folders as the scanned one. If the database also contains a scan of the migrated location (an Ultra fast scan is enough), SmartMapper checks every rule against it, proposes the right rule when the files are not where a rule sends them (for example when only the contents of a folder were migrated), and finds folders the migration tool renamed (for example ~Rec Logs to _Rec Logs). Rules backed by such evidence are added automatically; your existing rules are never changed, and the previous rules are listed in the log.
- New wizard step "Suggested mapping rules". After the keys are created, the SmartMapper wizard lists the rules it added, with the reason for each. Accept them, or delete the ones you do not want and recreate the keys with one click. The step is skipped when no rule was suggested. The migration rules list shows the origin of every rule: User, Suggested or Accepted.
- Rules to check. After the keys are created, the page Suggested mapping rules also lists your existing mapping rules that map no scanned document and are probably wrong or not needed - rules for local paths (C:\Users, C:\Program Files ...), rules whose links all point outside the scanned folders, rules superseded by more specific ones, and unused rules - with the number of links and of files that change only because of each rule. Delete the wrong ones and recreate the keys with one click; nothing is deleted automatically.
- A rule is no longer listed under "Rules to check" when the scan is of the migrated location. If you scanned the documents where they are now (for example on SharePoint after the migration) and their links still point to the old location (for example C:\Work\Migration\...), every link of the mapping rule pointed outside the scanned folders. The rule was therefore listed as outside scan (probably wrong) and the log showed a warning - even though it was the rule that all the keys were made with. Now a link counts as verified when the rule maps it to a document of the same scan, so such a rule is no longer listed and the log shows how many of its links were verified this way.
- SmartMapper warns about special characters in folder names. When keys point to folders whose names contain characters that migrations usually replace (for example ~Rec Logs → _Rec Logs) and the scan of the migrated location does not contain those folders, SmartMapper shows a warning with the number of keys and files and recommends an Ultra fast scan of the migrated location. On the Create keys page you can say whether the migration replaced such characters (I don't know / Yes / No).
- The Resolved Links export shows whether the new link's file exists on SharePoint. If the database holds a ReplaceMagic scan (Scan Documents) of the SharePoint site, the export has a new column TargetInScan: Yes, No, Not checked (a file type or folder that the scan does not contain) or No scan of this site. The message at the end of the export shows how many new links were found and not found. A link whose file is not on SharePoint usually was already broken before the migration. Tip: scan the SharePoint site with all the file types your links point to (for example also PDF and Word), otherwise these links are only "Not checked".
- Warning before SmartMapper changes documents at their source location. When a SmartMapper replacement is started on documents that are still at their old (source) location - for example after importing a saved run of a file share scan - ReplaceMagic now asks first. The message Documents at the SOURCE location shows how many of the documents to process have SmartMapper keys and are at the source (for example 8 of the 17 documents to process have SmartMapper keys and are at their SOURCE location), an example with its new location, and whether the Backup option is on. No (the default) cancels the replacement, Yes changes the documents in place. This is correct only when you repair the links before the migration; after the migration, scan the target location and run the replacement there. Command-line (silent) runs do not ask: they write a warning to the log and continue.
- Automatic database check in SmartMapper. When you start the SmartMapper wizard, and again before keys are created, SmartMapper checks the database structure and updates it if needed. This also covers databases that are marked as up to date but are missing required columns, for example a database connected through the DB Wizard. If the update is not possible, for example because of missing permissions or a read-only database file, SmartMapper shows a clear message and does not start key creation.
Process only the documents that can change
- Import only the documents that can change. When you import a saved run (Saved RUN(s) → Import), a new row above the runs lets you choose: All documents (default), Only documents with links (documents in which the scan found hyperlinks, OLE links, link sources, pivot tables or Power Queries) or Only documents with SmartMapper keys (exactly the documents the replacement will change). You can scan everything, create the keys for everything, and still open only the documents that will change - for example 27,067 of 1.1 million scanned documents. The documents grid shows only the imported documents and a message tells you how many were imported. If the run has no link counts (Ultra fast scan) or no SmartMapper keys yet, all documents are imported. In command-line (silent) runs the same choice is in Silent run params → SmartMapper options → Documents, saved as <SMARTMAPPERDOCUMENTS>All|WithLinks|WithKeys</SMARTMAPPERDOCUMENTS>.
- Process only the documents that can change - also at the target. The last page of the SmartMapper wizard now has the choice Documents to process: All documents, Only documents with links or Only documents with SmartMapper keys. It applies to the replacement you start from the wizard, also to a scan of the target location after the migration: with the keys of the source run, only the migrated documents that will change are opened - the target does not have to be saved in the database. Before the replacement starts, ReplaceMagic shows how many documents will be processed and lets you choose between only those and all documents. Only documents with links now uses the link counts of the documents being processed (a full scan of the target works too), also in command-line (silent) runs.
Several SharePoint sites in one run (Multi Site extension)
- Several SharePoint sites in one run. In the SharePoint Selection form you can now add more than one SharePoint site (site collection) - a new site is added to the sites already in the list instead of replacing them. Each site keeps its own connection: its own user, authentication mode, Microsoft Information Protection settings and, if used, its own additional SharePoint users. Sites can be in different tenants. Select locations from all sites and scan and replace them in one run; every document is opened and saved through the connection of the site it belongs to.
- Remove a single site. Right-click a site in the SharePoint Selection form and choose Delete to remove only that site, together with its selected locations. The other sites stay as they are, and the sites that were already in the list keep their expanded or collapsed structure when you add a new site.
- Time zone per site. The SharePoint time zone is read for every site, so the original Modified date is restored correctly for documents of each site, also in command-line (silent) runs.
- Command-line (silent) runs with several sites. The XML configuration contains the main site as before and one <SHAREPOINTCONNECTION> block for every additional site. If a site cannot be connected, only its locations are skipped (written to the log). Existing configuration files work without changes.
- Link check across sites. Links that point to another site in the list are checked through the connection of that site.
- Import of saved runs with several sites. When documents of a saved run are imported and the original Modified By is kept, the user is now looked up on the document's own site. Before, documents of an additional site could get the wrong user.
SharePoint Link items (.url)
- SharePoint "Link" items and Internet Shortcuts (.url) are supported. A Link item in a SharePoint library (Create or upload > Link) is a small .url file that points to another document or page. Until now ReplaceMagic did not process these files, so after a migration the Link items still pointed to the old location.
- Scan: the target of every .url file is shown in the Hyperlinks tab. LinkTitle is the name of the item exactly as in the Name column of the library (for example Document Control.url). The link is checked and used by SmartMapper like every other link.
- Replace: switch on Target Path and/or SharePoint .url files on the LNK/URL page. Only the target of the link is changed - the rest of the file (icon and other settings) stays as it is. The option Update text does not change .url files. If a replacement would leave a target that is not a complete link (for example an empty text or a path without a server or drive), the file is not changed and the reason is written to the log.
- SharePoint: when you click a Link item, SharePoint does not read the file - it uses an address it keeps for the item. ReplaceMagic now updates this address together with the file, so the Link opens the new location. The log shows .url: Link target in SharePoint updated for every changed item. In a library where ReplaceMagic does not check documents out, this second write makes one extra version of the item.
- File server: .url files in folders are changed in the same way.
- Windows Shortcuts (.lnk) on SharePoint are now skipped (listed among the skipped documents): they can be changed only in folders. Before, they were read as text and a key could change the binary file.
- url files are counted as Shortcuts in the scan and replacement dashboards, and are available in all ReplaceMagic editions that support Windows Shortcuts (.lnk).
SharePoint processing, sign-in and throttling
- Improved processing of documents on SharePoint (metadata, try...catch messages with better description...).
- New parameter Save without extra version under Configuration → SharePoint 1 - save documents with one new version instead of two. Without this option, restoring the original metadata (modified date, editor, approval status) creates an additional version after each save. If a server does not support it (for example SharePoint 2013), only that server falls back to two versions; other sites in the same run, and later runs, are not affected.
- Automatic re-login and clearer error reporting.
- Automatic re-login: if SharePoint stops accepting the sign-in during a run (HTTP 401/403), ReplaceMagic now pauses processing, signs in again and continues where it stopped. With Web Logon the sign-in window opens again and usually closes by itself; if SharePoint asks for a password or MFA, the user signs in. With user name/password and with app-only certificate authentication this happens without any user action.
- No more wasted retries: a document that SharePoint refuses is skipped immediately, instead of being retried five times with a sign-in that no longer works.
- Faster finish when sign-in cannot be restored: the remaining documents are skipped at once with a clear reason, so the run ends quickly and the documents can be processed again later.
- Fixed: with app-only certificate authentication every request failed after about one hour, because the access token was never renewed. It is now renewed automatically.
- Clearer log and skipped-documents list: they now state the real reason when a document is skipped because of sign-in problems, and what to check (for example, whether a document may still be checked out). The log also records why SharePoint refused the sign-in, which helps support find the cause.
- New settings on the SharePoint tab of the configuration: how long the Web Logon window waits for the user, the pause between attempts, and the maximum number of attempts (defaults: 5 minutes, 5 minutes, 6 attempts).
- Throttled documents are no longer skipped at once. When SharePoint throttles a request (HTTP 429 or 503), ReplaceMagic now waits as long as SharePoint asks (the Retry-After value) and then repeats the same step for the same document, up to 3 times. Only if SharePoint still throttles is the document skipped, as before. Before, the throttled document was skipped immediately and only the following documents waited. The wait time is now also taken from SharePoint when a document is downloaded or a link is checked (before: always 120 seconds for HTTP 503), and the countdown in the status bar now starts at the full wait time.
- A document could be skipped after throttling while its sharing links were read. If SharePoint throttled the request that reads the sharing links of a document, the following download of the same document failed five times with Cannot invoke HTTP DAV request. There is a pending query. and the document was skipped. Now the sharing links are read again after the wait requested by SharePoint (up to 3 times), and the download is no longer blocked.
- Decrease workload during SharePoint throttling: one step per throttling wave. When SharePoint throttled several documents at the same moment (HTTP 429 or 503), every one of them halved the number of documents processed in parallel - for example from 16 straight down to 1, so the rest of the run was much slower than needed. Now the parallel processing is halved once per throttling wave: within the wait time that SharePoint requested when it was halved (Retry-After, at least 5 seconds) it is not reduced again. If SharePoint is still throttling after that time, it is halved again. The log shows WORKLOAD REDUCED (from N threads to M threads) once per wave. This applies when Decrease workload during SharePoint throttling? is selected in the configuration - now also during a replacement: before, only a scan reduced the parallel processing, and a replacement kept running with the full number of documents while SharePoint throttled.
- Waiting for SharePoint no longer counts as processing time. When SharePoint throttles a document, ReplaceMagic waits as long as SharePoint asks (Retry-After, up to 3 times) and then continues with the same document. This waiting time was counted in the document processing timeout, so a document that had to wait twice (for example 95 + 177 seconds) was stopped and listed among the skipped documents, although it had not been changed yet. Now the waiting time is not counted. If a document is still stopped, the log shows how long it waited (throttling wait not counted: N s).
- Default wait for SharePoint HTTP 503 is 99 seconds, and the log shows where the wait time comes from. When SharePoint answers HTTP 503 without a Retry-After value, ReplaceMagic now waits 99 seconds (before: 120 seconds). The log line Retry-After now says whether the time came from SharePoint (Retry-After: 120 (from SharePoint)) or is the ReplaceMagic default (Retry-After: 99 (SharePoint sent no Retry-After - ReplaceMagic default)). Before, both looked the same. The default of Throttling retry-after period in the configuration is now also 99 seconds; a value you have already saved stays as it is.
- "Keep last modified date" moved some dates by one hour. On sites in a time zone with daylight saving time, a document whose Modified date was in the other half of the year (for example a February date while the site was converted with summer time) got a Modified date one hour later after the replacement. ReplaceMagic now converts every date with the daylight saving rule of the site's time zone for that date. Dates that were already moved are not corrected automatically.
- App-Only authentication cannot be combined with Microsoft Information Protection. In the SharePoint Selection form, Use MIP is now switched off and locked when App-Only client secret or App-Only certificate is selected (also for saved connections). SharePoint does not accept saving documents with an encrypting sensitivity label from an App-Only connection, so such documents could be read but never saved. A command-line (silent) run with App-Only and MIP in the XML file writes a note to the log and runs without MIP (no sign-in window). To process protected documents, use Web Logon (modern authentication) with MIP.
- Extended MIP logging.
- Search & Replace in SharePoint menus fixed. Replacements in the SharePoint Quick Launch and Top Navigation Bar are now saved. Before, ReplaceMagic found the menu links during the scan, but the changes to the menu entries could not be saved in SharePoint. Sub-menu entries are now processed with the search options you selected (Whole word only, Match case, Wildcards, Regular expression) - before, these options were passed on wrongly for sub-menus. With several Search & Replace keys, menus and list items now use the right search and replace pairs (before, from the second key on, wrong pairs were used).
- SharePoint lists. Update SharePoint List Items hyperlinks works again: the replacement in list items stopped with an error ("Conversion from string ... to type 'Integer'"), and after a timeout the list was reported as skipped - no list item was changed. If list processing fails, the reason is now written to the log and to the skipped documents at once. Several keys that change the description of a hyperlink column are now all applied (before only the last one); if SharePoint refuses to save a page of list items, the log and the problems list say so and these changes are no longer reported as done; the Document ID link of a list item (_dlc_DocIdUrl) is never changed; the scan export shows the correct address of a list or library, also when the whole list is selected (for example https://tenant.sharepoint.com/Lists/Links; before https://Lists/tenant.sharepoint.com or only the site address); for attachments of list items the log no longer shows "Problem to read SharePoint Shared Settings" (attachments have no sharing links). At the end of a replacement the log now shows how many list hyperlinks were changed (SharePoint list hyperlinks changed: N).
- Correct addresses for list item attachments on sites and subsites that are not the root site of the tenant (the site path was repeated in the address).
- Sharing links created with "Can review" and "Can't download" are read (new columns ReviewLink and BlockDownloadLink in scan results, exports, CSV import, database and saved runs). Links for "Anyone" and "People in your organization" created in the new SharePoint Share dialog are now shown as well.
- Reading of SharePoint sharing links is faster: documents that inherit permissions need one request instead of two.
- Selecting several locations at once fixed. In the SharePoint Selection form, when you selected several nodes (Ctrl+click) and one of them was already in the list of selected locations, the following nodes were silently skipped. Now every selected node is added.
- SharePoint pages: the page structure is protected. When changing Wiki pages, modern (Canvas) pages and Summary Links, a short search&replace key could also change the hidden structure of the page - for example the key Old changed the internal attribute data-sp-controldata, and the modern page was shown empty and could not be edited. Now the keys change only the visible text and the links - also the links in web part settings (for example the links of a Quick Links web part). Names of tags, attributes and settings, internal values of web parts (for example the layout of a News web part), layout data and IDs are never changed. Texts stored only in web part settings, such as the title of a News web part, are not changed either. If a key with wildcards or a regular expression would still damage the structure, the page is not saved and the problem is listed in the Search & Replace results.
- SharePoint pages: \ to / and / to \ change only links. On Wiki pages, modern pages and Summary Links the Convert options now change only link addresses (for example href and src of links and pictures, and links in web part settings). Normal text on the page, for example a path like C:\Temp\Data written as text, keeps its backslashes. Before, the conversion was applied to the whole text of the page when another selected area (for example Summary Links) allowed the Convert options.
- Quick Launch and Top Navigation Bar: link check. With Check if hyperlink exists (or broken link check) the column HyperlinkExists of menu items showed a wrong result. Menu links are now checked with their full address; a menu item without a link shows Link is without address.
- Quick Launch and Top Navigation Bar: every site is processed once. When several scans were made in the same ReplaceMagic session, the menus of a site were processed once for every scan - the log showed the same site several times, and a key that is part of its own replacement (for example A > AB) could be applied more than once. Now the menus of each site are processed exactly once per replacement, also when a parent site with subsites and one of its subsites are both selected.
- SharePoint sign-in lost during a long run: the run waits for you instead of skipping documents.
- If SharePoint stops accepting the sign-in and the automatic re-login does not succeed (for example, nobody answered the Web Logon window), ReplaceMagic now pauses the run and asks: Yes = sign in again, No = stop the run. While the question is open no document is skipped. Before, all remaining documents of the run were skipped, which on a large run could take hours and produce a very long list of skipped documents.
- If the sign-in cannot be restored (you choose to stop, or in a command-line/silent run), the run is stopped. Documents that were already open are listed as skipped; run it again after signing in - documents that were already changed no longer contain the old links.
- While ReplaceMagic signs in again, no new documents are started, and the waiting time no longer counts towards the document processing timeout (before, documents waiting for the sign-in were stopped as "long running").
- Long runs (several days) with Web Logon can now sign in again as often as needed: the limit of three automatic re-logins applies only within one hour.
- Recommendation: never run silent run if there is a risk that user credentials expire and re-logon is required.
- Shorter wait for a short SharePoint outage (HTTP 503). When SharePoint answers "503 Service Unavailable" without saying how long to wait (no Retry-After), ReplaceMagic now waits 10 seconds and tries the same document again; if such answers come again, it waits 20, 40 and 80 seconds. Only from the second such answer is the number of parallel documents reduced and processing paused. Before, every such answer meant 99 seconds of waiting and half of the parallel documents. When SharePoint does say how long to wait, ReplaceMagic waits exactly that long, also when SharePoint gives a date and time instead of seconds. The log shows the value SharePoint sent ("Retry-After (as sent by SharePoint)") and the request id.
SharePoint processing, sign-in and throttling
- Documents with an encoded character in the file name are processed correctly. A SharePoint document whose name contains a percent sign followed by two characters, for example "Report%20Final.docx" or "Link%25Sources.xlsx", was skipped with "(404) Not Found" in every scan when you sign in with a method other than App-Only. SharePoint read "%20" as a space and looked for a different document ("Report Final.docx"). If such a document existed in the same folder, ReplaceMagic read that other document instead, and a replacement could have saved the changed content into it. ReplaceMagic now sends the exact document name, so these documents are scanned and changed like any other document, and the other document is not touched. App-Only sign-in was not affected.
- A document that no longer exists on SharePoint is skipped at once. When SharePoint answers "(404) Not Found" for a document, for example because it was deleted or renamed after the scan, ReplaceMagic now skips it right away instead of trying 5 times with growing pauses. The log says "document not found on SharePoint (HTTP 404) - not retried" instead of "5th retry, download document failed".
- The log shows who decided how long to wait during SharePoint throttling. The line "Wait:" in the block IMPORTANT SHAREPOINT HEADERS and the line "SharePoint throttling (503): waiting ..." now name the source of the wait: "Retry-After from SharePoint" when SharePoint sent the time, "ReplaceMagic wait 1 of 4" when SharePoint sent no time (10, 20, 40, 80 seconds), or "configured Throttling retry-after period" when "Use SharePoint retry-after recommendation" is switched off. Before, the log always said "Retry-After", also when ReplaceMagic chose the time. How long ReplaceMagic waits did not change.
Link check
- Links to SharePoint sites you cannot access are no longer reported as broken. When a link points to a SharePoint site that the signed-in user cannot open (HTTP 401 or 403) - for example a site that is not in the SharePoint Selection form or a site in another tenant - the result is now Link not verified (code: 401, access denied) (or code 403) instead of Broken link, and the link is not counted as broken. Links to other web sites are checked as before. To check such links, add their site in the SharePoint Selection form.
- No more links without a result. If the SharePoint link check cannot be finished (for example when SharePoint throttles the requests), the result is now Link not verified (SharePoint check failed: ...) with the reason. Before, such links were shown without any result.
- Correct number of broken links per document. The number of broken links per document now matches the total in the result summary. Before, links checked over HTTP with the result Link OK (code: 200, OK) were counted as broken in the per-document number, and some failed checks were counted only per document and not in the total.
- More reliable link check on SharePoint. When documents are processed in parallel, every thread now checks SharePoint links through its own connection. Before, existing links could occasionally be reported as broken.
SharePoint illegal characters
- New option "Use optional illegal characters?" (Configuration → SharePoint 2): the characters # % & { } ~ are replaced only when this option is selected, while " * < > | ? are always replaced (when Replace SharePoint illegal characters? is on).
- Illegal characters are replaced only in the path of a link. Like the migration tools, ReplaceMagic now changes only the folder and file names of a link. The server address and everything after the file name stay as they are: the sheet name, cell range or table reference ('...\Stock.xlsx'!Data[#Data], [Plan.xlsx]Sheet #2), a bookmark or anchor (Report.xlsx#Sheet1!A1, Home.aspx#section2) and the query after "?". Encoded characters such as %20 stay as they are, in full links (https://company.sharepoint.com/Shared%20Documents/...) as well as in links without https:// (/Shared%20Documents/..., relative links). An encoded illegal character is replaced like the character itself (%23 = "#"), because it is part of the real file or folder name. In formulas and field codes only the quoted paths are converted. E-mail addresses (mailto:) are not changed. Tip: if your migration tool replaced only "#" and "%" (for example ShareGate), keep only these two in the optional list.
- Power Queries keep their formula when SharePoint illegal characters are replaced. With Replace SharePoint illegal characters and Power Queries selected (Configuration > SharePoint 2), the whole Power Query formula was converted, so its quotation marks became "_" and the query no longer worked. Now only the folder and file names in the paths of the formula are converted; the rest of the formula (quotation marks, https://, %20, delimiters) stays as it is.
Search & Replace options
- New option "Keys: Space<->%20" (first named "Keys: space = %20"). A link can be written with a space (Shared Documents) or with %20 (Shared%20Documents), and a search&replace key only finds the form it is written in. With the new option on the Search & Replace form, every key that contains a space is also used in its %20 form, and every key with %20 also in its form with a space - the replacement text is converted the same way. All spaces of a key are converted at once; text without %20 is never changed by the extra key. Keys you entered yourself in both forms are not doubled. The option is off by default; in a command-line run use <KEYSPACEVARIANTS>True</KEYSPACEVARIANTS>.
- Shorter option names on the Search & Replace form. Backslash to slash is now \ to /, Slash to backslash is now / to \ and Keys: space = %20 is now Keys: Space<->%20. The options work as before.
- Convert "\ to /" and "/ to \" only with links. The options are available only when an area with links is selected (now also Target Path on the LNK/URL page and SharePoint Summary Links). Before, an option that was switched on stayed active even after it was greyed out - for example with only Update text selected it converted backslashes in the whole text of the document. Now it is switched off when no area with links is selected.
- Replace Preview on local and network locations now opens documents only for reading (previously they were opened for writing). This helps a replacement preview when there are read-only files.
- The search&replace log no longer shows additional keys that came from the search string length and were not used for replacements but were misleading.
- Search & Replace without documents to process starts an Ultra fast scan. When you start Search & Replace without scanning first, ReplaceMagic runs an Ultra fast scan of the selected location and then the replacement. If ReplaceMagic had already marked the session as scanned (for example after the Search & Replace window was closed without a scan) the replacement started with an empty list and processed 0 documents. Now an empty list (no documents, lists or menus to process) always starts the Ultra fast scan first; the log says so.
- Much faster replacement with long lists of search/replace keys. ReplaceMagic now keeps the keys as a list in memory and first checks whether a key occurs in a link at all, before it prepares the replacement. With thousands of keys, a workbook with many links is processed in seconds instead of minutes, so far fewer documents reach the "Maximum time to process document" limit. The result of the replacement is exactly the same as before. Tip: an Excel workbook stores the address of a hyperlink encoded (a space as %20). If your keys contain spaces and should also change hyperlink addresses in Excel, switch on "Keys: space = %20".
Document types
- Documents are now saved to memory first. If saving fails, the original file stays unchanged, so files can no longer end up with 0 bytes. This applies to all supported document types.
- Improved processing of FieldCodes in Word documents.
- PDF Actions of type GoToRemoteAction are now processed (requirement: the linked file needs to exist on the new target location).
- Pivot table sources keep a "%" in the file or folder name. When the source of a pivot table was replaced and its path contained a "%" (for example Mob Data ex60% V2.xlsx), the new source was saved with a wrong character instead of "% V" and the pivot table could no longer find its data. The name is now saved exactly as it is - for links to SharePoint and for paths on a file server.
- Linked Excel charts in PowerPoint are now written with their real path (previously URL-encoded with %20), which was the cause of the "path too long" error on save.
- Improved processing of .htm and .html pages.
- Encoding improved for text-like files.
Command-line (silent) runs and encryption
- Command-line (silent) runs with several Search & Replace keys. Since version 2026.1.0.9 a silent run without SmartMapper read the search and replace texts from the XML file in the wrong order when there was more than one key: with two keys the second key was not applied, with three or more keys wrong pairs were applied (the replace text of one key with the search text of the next) and some documents failed with Collection index must be in the range 1 to the size of the collection. Runs with one key, SmartMapper runs and runs started from the ReplaceMagic window were not affected. If you use silent runs with several keys, check the documents processed with versions 2026.2.0.0 to 2026.2.4.4.
- Command-line (silent) runs use the search strings from the longest to the shortest. The key pairs from the XML file were used in the order of the file, so a short search string at the top of the list could change the beginning of a value that a longer search string was meant to replace as a whole. They are now sorted by the length of the search string, longest first, as in an interactive run; search strings of the same length keep the order of the XML file.
- Several XML files in one start. When ReplaceMagic was started with several XML files (ReplaceMagic.exe a.xml b.xml), the second file inherited every setting of the first one that it did not set itself - for example the SmartMapper run and its keys, the selected areas (Formulas ...), Backup, Match case, Results in database or the SharePoint data - and every file after the first one ran an Ultra fast scan. Now every XML file starts from the same initial settings. Runs with one XML file (for example from the Task Scheduler) were not affected.
- Command Line Parameters: easier run selection. The run list now shows the run ID first (e.g. 16 - SmartMapper - Scanning ...), so it stays visible for long run names. The list shows only runs that already have Search & Replace keys; a tooltip and the message shown when no such runs exist explain that keys are created in the SmartMapper wizard.
- Export to XML config file for App-Only with certificate authentication.
- "Encrypt connect data" now really encrypts the user name and password. When the XML file for command-line (silent) runs was created with Encrypt connect data, the user name and password could still be written as plain text (with Copy to clipboard, and with Save without copying first), although the file said they were encrypted. Now they are always encrypted, also for additional SharePoint sites. An empty password (for example with App-Only authentication) no longer causes an error. Please create again the XML files that were made with Encrypt connect data in earlier versions - they may contain the password as plain text. Old files still work.
- "Encrypt connect data" now also encrypts the App-Only certificate password. In the XML file for command-line (silent) runs the password of the App-Only certificate (main site and additional sites) was written as plain text, even with Encrypt connect data. It is now encrypted like the user name and password. XML files created with earlier versions still work; create them again so that the certificate password is no longer readable in the file.
- User names and passwords with special characters. Encrypt connect data (command-line XML) and the encrypted mail settings now encrypt user names and passwords with non-English characters (for example č, ž, ä, é, €) completely. Before, such values were cut off. Values with English letters, digits and the usual symbols are encrypted exactly as before, so existing configuration files keep working; if a saved user name or password contains such characters, save the settings or generate the XML file again.
Database
- Database version 2026.3.0.0. The new IdSourceRunID column (Resolved Links) is added automatically on SQL Server, MySQL and SQLite, and is included in new databases. The same applies to the new columns ReviewLink and BlockDownloadLink (scanned documents) and, on SQL Server, Filename (Unresolved Links; MySQL and SQLite databases already have it).
- Database version 2026.4.0.0. New column RuleOrigin (mapping rules) and the columns SmartMapperVersion and KeysCreated (runs - which SmartMapper version created the keys, and when). They are added automatically on SQL Server, MySQL and SQLite and are included in new databases. If an update step fails, it is now retried on the next start.
- Database update from older versions. Databases on version 2026.1 or older now receive all required update steps in one go. Previously the update could stop after one step, and SmartMapper then refused the database with the message "This database predates 2026.3.0.0". Update errors are now written to the log.
- SQLite database update: no more data loss. Updating an SQLite database from 2026.1 to 2026.2 could lose data: mapping rules, resolved and unresolved links, Search & Replace keys, the FullFolderPath column and database indexes. The same could happen when an update step ran again on an already updated database. All data and indexes are now preserved:
- the update verifies the copied data;
- if anything goes wrong, all changes are rolled back and the database stays as it was;
- steps that were already applied are skipped.
- The database is now updated automatically before a run writes its results. Before a scan with SmartMapper, a command-line (silent) run with Results in database or a SmartMapper silent run, ReplaceMagic checks the version and the table structure of the database and updates it if needed - silently, without a message window (the status bar and the log show it). Before, the database was updated only when Use SmartMapper was clicked, in the SmartMapper wizard or in the export windows: a silent run with an XML file created before the upgrade, or an older existing database chosen in DB Config, wrote into the old structure and the results were not saved (table ScannedDocuments has no column named UniqueID). If the database cannot be updated (for example no right to change the table structure, or a read-only database file), the documents are still processed and the log explains why the results could not be saved.
- Results with an apostrophe were not saved in the database. When the result of a link check contained an apostrophe (for example The remote name could not be resolved: 'www.example.com'), or a sheet name or a user name did (for example O'Brien), that row was not saved and the log showed SQL logic error. These rows are now saved.
- Export Run: the database update starts right after the "Database update required!" message, and "Database updated!" is shown only when the update succeeded.
- DB Wizard (SQL Server). After Create database, Next no longer says that the database does not exist (before, you had to go Back and click Check connection again). If the database exists but the user has no access to it, Check connection now says so instead of trying to create it again. Create database shows the real reason when it fails (for example CREATE DATABASE permission denied), creating the tables again in an existing database works, and Drop database no longer fails with "currently in use". Long messages in the status bars and in the Create database list are shown in full in a tooltip or with a double-click.
Import and export of scan results
- Scan Documents export. Without the "Include" options the export had a fixed set of 30 columns and showed the UniqueID value in the spGUID column; with the "Include" options it produced only the "Scanned documents" sheet; the detailed export showed the owner in the "Last Editor" column. All fixed.
- Import of exported CSV files with commas in names fixed. The CSV export for Import files puts values that contain a comma in quotation marks (for example the folder "H,S&E Advisor" or a user name "Smith, John"), and so does Excel when such a file is edited and saved. Import files did not remove these quotation marks, so documents with a comma in the folder or file name could not be opened, and SharePoint metadata with a comma (for example the names of Created By / Modified By users or check-in comments) was read with the quotation marks. Now these values are read correctly.
- Import of scanned documents: values over several lines. A value in the CSV file that contains a line break (for example a comment in the SharePoint metadata file SP_...) split the document into two broken rows. Such values are now read correctly. If a quote in the file is never closed, the rows are read one by one as before.
- CSV import of older export files no longer writes the folder path into columns that did not exist in the file (FullFolderPath, UniqueID, spGUID).
Other
- Complete lists of skipped documents and replacement problems. When many documents were processed in parallel and several of them were skipped or had a problem at the same moment, some entries could be missing from the list of skipped documents or from the Search & Replace problems, and the same number could appear twice. The counters were correct, only the lists were incomplete. Now every skipped document and every problem is listed, numbered without gaps or repeats. The documents themselves were not affected.
- Parallel processing stays at the set number of documents. When ReplaceMagic stopped a document because it took too long (document processing timeout), or when you stopped it in the Active Documents window, the document was counted as finished twice. After several stopped documents ReplaceMagic started more documents at the same time than set in Parallel document processing - for example many large presentations at once - which slowed the computer down and could cause even more timeouts. Now a stopped document is counted once, and the number of documents processed at the same time (Used parallelism in the Active Documents window) stays exact. In the log, a document you stop yourself in the Active Documents window is now shown as Stopping document, manually stopped in Active Documents - before it looked like a timeout.
- Long paths: the log now shows whether long paths are supported and which setting is required.
- Updated license agreement released (see installation folder).
- Faster replacement with a long Include/Exclude list. When the filtering rules are set for replacements (Processing Filter: "Exclude/Include rules for: replacements"), ReplaceMagic now applies the list once, before the replacement starts. The number of documents at the start of the replacement, the progress bar and the Replacement dashboard now show only the documents that are really processed. Before, they showed all scanned documents. Long lists, for example an Include list with thousands of documents, no longer slow down the replacement. The log now has one summary line, for example "4,046 of 239,512 documents are processed, 235,466 skipped by the filter". It no longer has one line "Document skipped due to selected filters!" for every document. The filter settings (Include or Exclude, files / folders / files and folders, number of strings, scanning / replacements) are now written at the top of the log. Empty strings in the list are ignored. Before, an empty line in an imported list matched every document.
- SmartMapper: warning for documents with keys that are not found. Before a SmartMapper replacement, ReplaceMagic now checks whether all documents with keys of the run are in the documents to process. SmartMapper finds the keys of a document by its path, so the links in documents that were not migrated, deleted, moved or renamed by the migration tool (for example ShareGate replaces "#" and "%" with "_") were not changed, and nothing showed it. Now the message "Documents with keys not found" shows how many documents are missing, an example, the possible reasons and what to do. The replacement then continues with the other documents. The full list is saved next to the log. A command-line (silent) run writes the same information to the log and shows no message.
- Log of the replacement with a processing filter. At the end of the log, "Number of processed documents/lists" now shows the number of documents after the filter, the same number as in the Replacement dashboard. Before, it showed all scanned documents.
- Database export with long date formats. Saving a scan or a SmartMapper run to a SQL Server or MySQL database failed when the Windows date format is long, for example the US format with AM/PM ("String or binary data would be truncated ... column 'StartTime'"). The date and time columns are now longer, and existing databases are updated automatically before the next export.
What is new?
New in version 2026.2.0.0 (28th of August, 2026)
- 🚀 NEW: ReplaceMagic.SmartMapper – Intelligent Migration Mapping—the new migration intelligence engine that automatically generates Search/Replace keys, eliminating one of the most time-consuming tasks in large-scale document migrations.
The biggest ReplaceMagic enhancement to date. SmartMapper eliminates the need to manually create thousands of Search/Replace patterns during document migrations. It automatically analyzes the links discovered by a ReplaceMagic scan, applies your migration mapping rules, and generates optimized Search/Replace keys for hyperlinks, SharePoint links, relative links, Excel references, OLE objects, Power Query connections, connection strings, and many other supported link types. Simply review the generated patterns, approve the results, and let ReplaceMagic repair your documents with confidence. See the new SmartMapper Help section for a complete step-by-step guide.
- Improved handling of SharePoint document libraries with mandatory metadata fields. If a required field has no value, ReplaceMagic now reports the actual SharePoint error instead of the previously misleading "Version conflict" message. The new message clearly identifies the problem - "You must fill out all required properties before checking in this document."
- Extended the log file to include the parallelism factor used during processing.
- Added startup event logging (available on request from the ReplaceMagic team for advanced troubleshooting).
- Fixed a problem that could corrupt PowerPoint presentations containing external charts when replacement strings included line breaks. ReplaceMagic now automatically removes line breaks from replacement strings in this specific scenario, ensuring file integrity.Improved processing of HTML (.html and .htm) documents.
- Added protection against generating Excel links that exceed Microsoft's maximum supported length. ReplaceMagic now prevents replacements longer than 253 characters (legacy Excel formats) or 2,000 characters (modern Excel formats), avoiding document repair warnings and hidden or removed link sources.
- Improved processing of Azure Information Protection (AIP) encrypted documents.
- Extended the Azure App Registration documentation with certificate authentication requirements.
- Improved caching of Azure Information Protection authentication.
- Added support for App-only certificate authentication (Microsoft Entra ID) for environments that do not require Microsoft Information Protection (MIP/AIP).
- Fixed replacements in Microsoft Word hyperlinks containing a subaddress (the part following the # character).
Server Migration and Broken Office Document Links: The Complete Fix Guide
A server migration—whether you are renaming a file server, replacing aging hardware, or moving shared drives to new infrastructure—is supposed to be invisible to end users once it is complete. In practice, the migration almost always surfaces one persistent problem that IT teams did not plan for: thousands of Office documents that contain embedded links pointing to the old server name or the old UNC path. Those links are now broken. Documents that previously opened linked data from a network share now display errors. Workbooks that pulled data from other Excel files show broken references. Word documents with linked objects display placeholder boxes instead of live content. This guide covers what happens to embedded Office document links during a server migration, which document types and link types are affected, and how to fix them at scale using ReplaceMagic's server migration workflow.
What Happens to Embedded Links When a Server Is Renamed or Replaced
Every embedded link in an Office document is stored as a string—a path, a URL, or a reference that was accurate when the link was created. When the server that hosts the referenced content is renamed or replaced, that string becomes stale. The document has no mechanism to detect that the server no longer exists at the old name; it simply tries to resolve the reference and fails.
For file server migrations, the typical change is a UNC path substitution: \\OldServer\Finance\Budget2024.xlsx becomes \\NewServer\Finance\Budget2024.xlsx. This looks simple, but the change must be applied to every link in every document across every file share—a task that can encompass hundreds of thousands of files in a large organization.
Which Document Types Are Affected
ReplaceMagic handles link repair across the full range of Microsoft Office document formats:
- Word (.doc, .docx, .docm): Hyperlinks, linked OLE objects, linked images, cross-document references, VBA project references.
- Excel (.xls, .xlsx, .xlsm, .xlsb): External workbook references in formulas, linked charts, OLE objects, named range links, VBA project references.
- PowerPoint (.ppt, .pptx, .pptm): Hyperlinks, linked media, linked OLE objects, action button links, VBA references.
- Visio (.vsd, .vsdx): Hyperlinks, linked data sources, OLE objects.
- Microsoft Project (.mpp): Resource links, cross-project dependencies, hyperlinks.
In environments where multiple Office versions are in use, both the legacy binary formats (.doc, .xls, .ppt) and the modern XML-based formats (.docx, .xlsx, .pptx) are processed correctly.
Which Link Types Break
Hyperlinks
Hyperlinks are the most visible broken link type. Embedded in document text, shapes, or buttons, they point to files, network locations, or web addresses. After a server rename, every hyperlink containing the old server name is broken.
OLE Links and Linked Objects
OLE (Object Linking and Embedding) allows Office documents to embed live references to content in other files—for example, an Excel chart linked into a Word report. The link stores the full path to the source file. When the server is renamed, the OLE link source path is stale and the embedded object cannot refresh its data.
External Link Sources in Excel
Excel workbooks frequently reference cells in other workbooks using formulas like ='\\OldServer\Finance\[Budget2024.xlsx]Sheet1'!$B$4. After migration, every such formula contains a broken path. These broken external references cause recalculation errors and can cascade through dependent calculations.
VBA Project References
Macro-enabled documents sometimes reference external libraries, add-ins, or other documents via VBA code paths. Server renames break these references silently—the code appears intact but fails at runtime when it attempts to access the old path.
Headers, Footers, and Document Properties
Links embedded in document headers and footers, or stored in custom document properties, are frequently overlooked but are repaired by ReplaceMagic as part of a complete fix pass.
Why Opening Each File Manually Is Not an Option at Scale
The instinctive response to a broken link is to open the document and fix it. For a single document this takes a few minutes. For an environment with 20,000 documents across shared drives, the arithmetic is brutal: at five minutes per document, manual repair would require 1,667 hours of focused work—nearly a full year for one person. And that assumes every document can be found, every link type is identified correctly, and no mistakes are made along the way.
The manual approach also misses link types that are not visible in the normal document view. OLE link sources, VBA references, and links in document properties do not appear in the main editing area and require navigating through multiple dialog boxes to find and update. A repair process that relies on human inspection will almost certainly leave a significant fraction of broken links unrepaired.
How to Use ReplaceMagic: The Complete Workflow
Step 1: Run a Pre-Migration Scan
Before the server migration takes place, run ReplaceMagic in scan mode against your file shares. This produces a baseline inventory of every link in every document. The scan identifies the old server name in all its forms—NetBIOS name, FQDN, IP address—so that replacement rules can cover every variant. The baseline also reveals documents that already contain broken links before migration, which is important for scoping the post-migration repair effort accurately.
Step 2: Configure Search and Replace Rules
Using the scan output, configure replacement rules in ReplaceMagic. For a server rename, the primary rule maps the old server name to the new server name across all link types. Additional rules handle variants: the old IP address, alternate path formats, or secondary shares that moved to different locations. Rules are applied to hyperlinks, OLE sources, external formulas, VBA references, headers, footers, and document properties in a single pass.
Step 3: Run a Preview Pass
Before committing any changes, run the replacement in preview mode. ReplaceMagic processes every document and reports exactly what would change in each file—without writing any changes to disk. Review the preview report to confirm that the rules are matching the right content and producing the correct substitutions. Adjust rules if necessary and preview again.
Step 4: Execute the Repair
Once the preview is satisfactory, run the full replacement. ReplaceMagic processes documents in parallel using multiple threads, completing large document sets in a fraction of the time a sequential tool would require. Each processed document is optionally backed up before modification. Metadata—last-modified date, author—can be preserved so that the repair pass does not pollute file system timestamps or SharePoint version histories.
Full instructions for configuring and running the repair are available in the How to Fix Broken Links guide.
Tips for Large Migrations
Batch Processing by Share
For very large environments, process one file share at a time. This makes it easier to validate results, rerun individual batches if rules need adjustment, and distribute work across maintenance windows.
Parallel Licensing for Multiple Teams
ReplaceMagic licenses can be deployed on multiple machines simultaneously, allowing different teams to process different file shares in parallel. For organizations with geographically distributed file servers, this can compress a multi-week repair project into a single weekend. See the ReplaceMagic Professional license options for details.
Preserve Backup Copies
Always configure ReplaceMagic to create backup copies of documents before modification. This provides a recovery path if a replacement rule produces unexpected results in a particular document type or format version.
Key Takeaways
- Server migrations break embedded links in Word, Excel, PowerPoint, Visio, and Project documents by invalidating the server name embedded in every link path.
- Affected link types include hyperlinks, OLE links, external Excel formula references, VBA project references, and links in headers, footers, and document properties.
- Manual repair is not feasible at scale—even 100 documents is a significant manual effort; thousands or tens of thousands requires automation.
- Running a pre-migration scan establishes a baseline and ensures replacement rules cover every variant of the old server name.
- ReplaceMagic processes documents in parallel without requiring Microsoft Office to be installed, completing large repairs quickly and accurately.
Start Fixing Broken Links Today
Download the free trial from the ReplaceMagic Downloads page to scan your document library and see the full scope of broken links before the migration—or after. When you are ready for the full repair, visit the ReplaceMagic Store to select the license that matches your document volume and processing needs.
Why SharePoint Migrations Break Your Office Document Links (And How to Fix Them)
SharePoint migrations are a fact of life in modern enterprise IT. Whether your organization is moving files from a network share to SharePoint, upgrading from SharePoint on-premises to SharePoint Online, or consolidating multiple tenants into one, the migration itself is only half the story. The other half—the part that rarely makes it into the project plan—is what happens to the thousands of Office documents that contain embedded links referencing the locations those files used to live. Links break. Workbooks stop refreshing. Presentations display error placeholders instead of linked objects. Reports point to documents that no longer exist at the expected address. This article explains why each type of SharePoint migration breaks document links differently, and how to fix the problem at enterprise scale.
The Three Main SharePoint Migration Scenarios
Scenario 1: File Server to SharePoint
When an organization migrates content from a traditional Windows file server to SharePoint, UNC paths like \\FileServer01\Departments\Finance\Budget.xlsx are replaced by SharePoint URLs like https://contoso.sharepoint.com/sites/Finance/Budget.xlsx. Every document that embedded a UNC path link to another document now contains a broken reference. The link format changes completely—from a file system path to a web URL—which means simple string substitution is necessary but not sufficient if the file structure was also reorganized during the move.
Scenario 2: SharePoint On-Premises to SharePoint Online
Moving from SharePoint Server on-premises to Microsoft 365 SharePoint Online changes the URL scheme fundamentally. An on-premises link like http://sharepoint.contoso.local/sites/Finance/Documents/Budget.xlsx becomes https://contoso.sharepoint.com/sites/Finance/Documents/Budget.xlsx. The protocol changes (HTTP to HTTPS), the host changes, and sometimes the site structure is reorganized in the process. Documents that contain embedded links to on-premises SharePoint addresses will all fail to resolve after migration. For detailed guidance on this specific scenario, see the SharePoint On-Premises to Online migration guide.
Scenario 3: Tenant-to-Tenant Migration
Tenant-to-tenant migrations are the most complex scenario. In addition to URL changes, the internal SharePoint item IDs that uniquely identify each document within a site are regenerated from scratch in the destination tenant. Documents that were linked using ID-based references cannot be repaired by simple URL substitution; the old ID simply does not exist in the new tenant and must be mapped to the new ID for each target document individually.
Why Each Scenario Breaks Links Differently
In a file server to SharePoint migration, the link format itself changes, but the content being linked has not moved internally—it is just at a new address. Repair is primarily a URL format transformation problem.
In an on-premises to online migration, the domain, protocol, and sometimes the path all change, but the SharePoint internal IDs may be preserved if the migration tool was configured to do so. Repair requires careful URL mapping that accounts for every variant of the on-premises address.
In a tenant-to-tenant migration, all of the above apply, plus ID-based links must be resolved through a mapping table. This makes tenant-to-tenant migrations the scenario most likely to leave persistent broken links if the repair is not planned and executed carefully.
The Scale of the Problem in Enterprise Environments
Enterprise SharePoint environments accumulate content over years or decades. A mid-sized organization with 500 users will typically have tens of thousands of Office documents stored in SharePoint. A large enterprise may have millions. In these environments, even a conservative estimate—say, that 20 percent of documents contain at least one embedded link that breaks during migration—produces a repair scope of thousands to hundreds of thousands of documents.
The problem is compounded because broken links do not all manifest immediately. Users discover broken links organically, weeks or months after migration, when they open a document and find that a linked report no longer refreshes, or that a linked image in a presentation has been replaced by a red X. By that point, the migration project has been closed, the team has moved on, and no one has a complete picture of the repair scope.
What IT Teams Typically Try First (And Why It Falls Short)
The most common initial response is to ask users to fix their own documents. This fails because most users do not know how to locate and update OLE link sources, external formula references, or VBA project paths. They can update a hyperlink they can see, but the deeper link types remain broken.
The second response is to assign the repair to the IT team using manual methods—opening each document, running Find and Replace, and saving. This fails at scale for the reasons described above: it is too slow, too error-prone, and misses link types that are not visible in the editing interface.
Some teams attempt to use PowerShell scripts to search and replace text in document files. This can work for simple hyperlinks in OOXML format documents, but it is fragile, risks corrupting documents if the XML structure is not handled correctly, and does not cover binary format documents, OLE link sources, or Excel external formula references.
How ReplaceMagic's Native SharePoint Integration Works
ReplaceMagic Ultimate connects directly to SharePoint Online using the Microsoft Graph API and SharePoint REST API, allowing it to enumerate document libraries, download documents for processing, and upload corrected versions—all without requiring manual file downloads or uploads. The SharePoint integration guide covers configuration in detail.
When ReplaceMagic processes a document from SharePoint, it downloads the file, applies all configured replacement rules across every link type in the document, and uploads the corrected version back to SharePoint. The entire cycle is automated and runs in parallel across multiple documents simultaneously. A document library containing 10,000 files can typically be fully repaired in a matter of hours rather than weeks.
For the full range of SharePoint migration scenarios, see the Migration to SharePoint overview page.
Metadata Preservation: Why Keeping Last-Modified Date and Author Matters
One concern IT teams frequently raise is the impact of a repair pass on document metadata. If ReplaceMagic updates a document and saves it, SharePoint will record the new save time and the account that performed the save as the last-modified timestamp and last-modified author. This can confuse users who see documents appearing as recently modified when the only change was a URL repair, and it can affect compliance workflows that rely on accurate modification history.
ReplaceMagic addresses this by offering metadata preservation mode. When enabled, the tool reads the original last-modified timestamp and author from the document before processing, then writes those original values back after saving the corrected file. The result is a repaired document whose metadata reflects its original edit history rather than the date of the repair operation.
SharePoint Check-In and Check-Out Handling
Document libraries with required check-out enabled present an additional challenge for bulk processing tools. ReplaceMagic handles check-out automatically: before processing a document, it checks the document out if required by the library settings, processes and uploads the corrected version, then checks the document back in with a configurable check-in comment. Documents that are already checked out by another user are skipped and logged for review, ensuring that the repair pass does not conflict with active user sessions.
When to Involve Expert Support
For organizations with highly complex migration scenarios—multiple source tenants, significant URL restructuring, or a mix of link types that requires a carefully constructed rule set—the ReplaceMagic Consulting Services and Premium Support options provide hands-on assistance from specialists who have worked through dozens of enterprise migration scenarios. Expert involvement at the rule-construction phase significantly reduces the risk of an incomplete or incorrect repair run.
Key Takeaways
- Every major SharePoint migration scenario—file server to SharePoint, on-premises to online, tenant to tenant—breaks embedded Office document links, but each breaks them in a different way.
- ID-based links in tenant-to-tenant migrations require a mapping table and cannot be repaired by URL substitution alone.
- Enterprise environments contain far too many documents for manual repair to be practical; automated bulk processing is required.
- ReplaceMagic integrates natively with SharePoint Online, handling check-out, check-in, and metadata preservation automatically.
- For complex migrations, expert consulting services can dramatically reduce the risk of an incomplete repair.
Ready to Repair Your SharePoint Document Links?
Download the free trial from the ReplaceMagic Downloads page to run your first scan and see exactly which documents are affected and which link types are broken. When you are ready for the full repair, visit the ReplaceMagic Store to find the right license for your environment.
What is new?
New in version 2026.1.0.0 (2nd of January, 2026)
- Fixed an issue where sequential search-and-replace operations on SharePoint pages could overwrite each other. Previously, if one string replacement was executed in one run and a second replacement in a subsequent run, the initial change could be undone. This behavior has now been corrected. More available here!
- Fixed an issue where the size of the Hyperlinks, OLE, Link Sources, Pivot, and PowerQueries result grids was not correctly restored after importing data from previous scanning runs stored in the database.
- Added ReplaceMagic start-up progress bar to visualize what is happening during start of application.
- Added support for Link Source replacements if they are grouped (GroupShape) in PowerPoint documents.
- Added support for OLE replacements if OLE objects are grouped (GroupShape) in PowerPoint documents.
- Added support for nested GroupShares in PowerPoint documents.
- Fixed that when during export there are multiple worksheets all are properly formatted and not only first worksheet.
- Fixed bug as Organization and Anonymous links were not shown in result lists.
- Extended conversion of PDF LaunchActions to URIActions which is required if links are changes from file system to http(s) links. Without this functionality, replacements will work but click on link will not do anything as LaunchActions can open only file links.
- If the replacement link source exceeds 235 characters, ReplaceMagic will not perform the replacement by default. Starting with this version, the notification has been extended to include the length of the replacement as well as the specific replacement value, providing a clearer warning message.
- Extended ReplaceMagic to report how many Excel Cells or PDF Text Fragments, if "update Text" is selected, are processed before timeout. This option is enabled only if you select Replace Preview option:


Number of processed cells is shown under "Skipped Documents" tab in Error field:


Same will work also for processing of Text Fragments in PDF documents.
Additionally, ReplaceMagic will also show all potential changes in Search & Replace tab and under Additional Info column, you will see if change belongs to the skipped document:


- Added possibility to stop processing of cells in Excel documents after entered number of cells (if update Text is selected):


If number is set to 0, no limit is applied. This can be used in combination with "Excel Cells Counter" from Skipped Documents tab but keep in mind that "Excel Cells Counter" is just estimate as it will depend on current run and might happen that during real replacement run this number deviates from what was measured during Replace Preview mode.
Important: processed cells counter is reset after every worksheet!
- Added possibility to import list documents for processing:


Format is that full document path has to be in single line.
- Fixed bug that import of ultra-fast scanned documents did not work. This will work for future exports!
- Added scroll bars (vertical and horizontal) in Import Found Files forms:


- Extended support that export to CSV format is working for more than 1.048.576 lines.
- Per default, in case of changes in text/custom file formats, ReplaceMagic will show as a replacement result search and replace strings as otherwise complete content of text file has to be shown. Now, there is parameter where it can be instructed to show complete text:

Result will look like:

- In case that you want to export replacement run results to Excel but length of OldValue and/or NewValue is longer than 32767 characters export did not work. This is happening as Excel cell has limit to store maximum 32767 characters. To avoid this, replacement run exports where length is above 32767 characters will be limited to this size.
- Export to database rewritten - initially, every new ReplaceMagic could introduce new database structure which would cause that previous saved runs are deleted to be able to recreated new database structure. From this version, we will keep previous runs but, of course, they will miss just included fields tables. Nevertheless, import of older runs should work (runs from version 2025.1 and 2025.2). More details in DB Configuration.
New in version 2025.1 (21st of March, 2025)
- Extended ReplaceMagic with functionality to store scan or replacement results in database (options: SQLite (default, not recommended for larger locations), MySQL or SQL Server (or SQLServer Express)).
Database configuration is possible over Configuration => DB Config:

More details under Configuration => DB Config section
To save scanning results use Export Run in Scan documents tab.
To save replacement results, use Export Run in Search & Replace tab.
To import saved run results use either Import Run in Scan documents or Search&Replace tab or over Configuration => DB Config
- Extended Scan Documents and Search & Replace tab to include filtering and run export and import functionality:


Over Filtering, you can specify which documents should be excluded or included based on provided strings and select where strings should (or not be):

One example - processing of SharePoint locations is always fully on selected location but with filtering you will have option to exclude everything what is not of your interest helping you to reduce number of documents what will be processed.
- Export Run - with this feature you will have possibility to save scanning or replacement in database for later usage:

or

Where you can set run name for later reference and export operation results.
- Import Runs will allow to import previously saved runs and continue processing directly over saved result set:

- Extended document filtering during scanning or replacement process (replacement was added with this release):


More details under:
- Extended ReplaceMagic to allow processing of table content in PowerPoint (process is executed when changes in Text area are selected)
- Further processing performance improvements
- Extended ReplaceMagic to include in scanning result SharePoint shared link and share token. As this will create additional workload on SharePoint, option is not active per default and has to be enabled over Configuration => SharePoint 1:

Already created exports which are used for import will not work any more and it is critical to check if in:
- c:\Users\YOUR_USER\AppData\Roaming\ReplaceMagic"
- "c:\Users\YOUR_USER\AppData\Local\ReplaceMagic"
- "c:\ProgramData\ReplaceMagic"
you have file(s) grid*Layout.xml which has to be deleted as otherwise new exports will not work.
Shared links are used by SharePoint when you click on:

- Limitation: for files with special characters (like # and similar) SharePoint is reporting problems to provide shared link and share token. Following special characters, even if they are allowed in folder/file name, are causing problem to read shared links and/or share token:
- Tilde (~)
- Number sign (#)
- Percent (%)
- Ampersand (&)
- Asterisk (*)
- Braces ({ })
- Backslash (\)
- Colon (:)
- Angle brackets (< >)
- Question mark (?)
- Slash (/)
- Plus sign (+)
- Pipe (|)
- Quotation mark (")
- Limitation: list attachments cannot have shared link/share token and that will be reported in scanning output result
- Limitation: list and/or list item shared links are not supported
- Fix bugs in Pivot processing
- Added functionality to delete result grid layout, if it exists, in case that additional result fields are introduced. Otherwise, exports might not work without manual layout file deletion.
- Export and import functionality completely rewritten. Remark: previous export might not work anymore for import!
- Added option to enable or disable Autofit columns in Excel export. During test run with around 500000 rows for export, with enabled option export took around 80 seconds and without around 20 seconds. This option will shorten duration of large exports:

but columns in Excel file will not be expanded according to the content which can be manually done directly in Excel. Default setting is true (option is enabled).
- Fixed scanning of emails where link is containing %20 which were shown as spaces leading that there was no replacement match.
In today's digital-first world, organizations are increasingly migrating their document storage and management systems to the cloud. Cloud-based solutions offer scalability, cost-effectiveness, enhanced collaboration, and security, making them an attractive choice for businesses of all sizes. However, transitioning from on-premises systems or older cloud platforms to modern cloud-based document management solutions is not without challenges. Among the most pervasive issues encountered during such migrations is the problem of broken links. This article explores the challenges associated with cloud-based document migration, with a particular focus on broken links, and discusses how tools like ReplaceMagic can help resolve these issues efficiently.
The Importance of Cloud-Based Document Migration
Cloud-based document management systems offer several advantages, including:
- Accessibility: Documents stored in the cloud can be accessed from anywhere, facilitating remote work and collaboration.
- Scalability: Organizations can scale their storage requirements based on demand without significant upfront investment.
- Security: Leading cloud providers offer robust security measures, including data encryption and regular backups.
- Cost Efficiency: Cloud platforms reduce the need for maintaining physical infrastructure, cutting operational costs.
Despite these benefits, the migration process often presents significant technical and logistical hurdles.
Challenges in Cloud-Based Document Migration
1. Complexity of Legacy Systems
Many organizations operate on legacy document management systems that were never designed with cloud migration in mind. These systems often lack standard file structures, metadata, and version control, making the migration process complex and time-consuming.
2. Data Volume and Diversity
Large organizations manage vast quantities of data, often in diverse formats such as Word documents, PDFs, spreadsheets, presentations, and multimedia files. Consolidating and transferring this data to the cloud requires careful planning to ensure integrity and usability.
3. Broken Links: A Critical Problem
Broken links are among the most pervasive and disruptive issues encountered during cloud-based document migration. Internal links within documents often point to other files or resources stored in specific locations. When these documents are migrated to a new system, the file paths and URLs may change, causing these links to break.
Why Broken Links Matter:
- Loss of Productivity: Broken links can lead to frustration and wasted time as employees search for missing files.
- Disrupted Processes: Automated workflows dependent on linked documents may fail, disrupting operations.
- Compliance Risks: In industries with strict compliance requirements, broken links can result in non-conformance issues if critical documents are inaccessible.
- User Experience: For organizations offering customer-facing documents, broken links can harm their reputation.
4. Permissions and Security Issues
Migrating documents to the cloud often involves transferring sensitive data. Ensuring that permissions and security settings remain intact during the migration process is critical to preventing unauthorized access.
5. Metadata Loss
Metadata, such as creation dates, authorship, and tags, is often critical for document searchability and organization. During migration, there’s a risk of metadata being lost or corrupted.
6. Downtime and Business Continuity
Migration can disrupt daily operations, especially if unforeseen challenges arise, such as compatibility issues or incomplete transfers.
Addressing Broken Links in Document Migration
Identifying Broken Links
The first step in addressing broken links is identifying their existence and extent. This can be a daunting task when dealing with thousands of files, especially if links are embedded within documents rather than as standalone hyperlinks.
- Automated Scanning Tools: Automated tools can crawl through documents and detect broken links, providing a report for analysis.
- Manual Testing: Although effective for small-scale migrations, manual testing is impractical for larger datasets.
Resolving Broken Links
Once broken links are identified, the next step is to resolve them by updating the link paths to reflect the new file locations. This process involves:
- Mapping Old Paths to New Locations: Creating a mapping between the original file paths and their corresponding locations in the cloud.
- Updating Links in Bulk: Using specialized tools to automate the process of link replacement across multiple documents.
How ReplaceMagic Helps in Resolving Broken Links
ReplaceMagic is a powerful tool designed to simplify the process of updating links and references within documents during cloud migration. Its advanced features make it an invaluable asset for organizations facing the challenge of broken links.
Key Features of ReplaceMagic:
- Batch Link Replacement
ReplaceMagic allows organizations to update internal and external links across thousands of documents in a single operation. This feature is especially useful for large-scale migrations where manual updates would be infeasible.
- Support for Multiple File Types
The tool supports a wide range of file formats, including Microsoft Office documents (Word, Excel, PowerPoint), PDFs, and more. This ensures that all types of files can be processed efficiently.
- Search and Replace Across Directories
ReplaceMagic can search for specific text strings, file paths, or URLs across entire directories and replace them with updated references. This ensures consistency and accuracy.
- Preservation of Document Integrity
Unlike some tools that risk corrupting files during the replacement process, ReplaceMagic ensures that the structure and formatting of documents remain intact.
- Customizable Rules and Filters
Organizations can define custom rules and filters to target specific files or links, making the replacement process more precise.
- Reporting and Auditing
ReplaceMagic generates detailed reports, allowing organizations to track which links were updated and verify the accuracy of changes.
A Step-by-Step Approach to Resolving Broken Links with ReplaceMagic
Step 1: Prepare for Migration
Before starting the migration process, create a detailed inventory of all documents, their locations, and the internal or external links they contain. This inventory will serve as a roadmap for the migration.
Step 2: Install and Configure ReplaceMagic
Download and install ReplaceMagic on a suitable system. Configure the tool by defining the directories to be scanned, the file types to be processed, and the new file paths or URLs.
Step 3: Scan for Broken Links
Use ReplaceMagic to scan the document inventory for broken links. Review the generated report to identify all instances where links need to be updated.
Step 4: Define Replacement Rules
Set up replacement rules in ReplaceMagic to map old file paths to their new cloud-based locations. These rules can be customized to handle different file structures or naming conventions.
Step 5: Execute Batch Replacement
Run the batch replacement operation. ReplaceMagic will update all specified links, ensuring they point to the correct locations in the cloud.
Step 6: Verify and Validate
After the replacement process, use ReplaceMagic's reporting features to validate the changes. Conduct random checks to ensure that all links are functioning correctly.
Step 7: Finalize Migration
Once broken links are resolved and verified, complete the migration process by transferring any remaining data and configuring user access permissions.
Benefits of Using ReplaceMagic for Document Migration
- Time Savings: Automated link replacement significantly reduces the time required to resolve broken links, enabling faster migrations.
- Cost Efficiency: By minimizing manual effort, ReplaceMagic lowers the overall cost of the migration process.
- Accuracy: Automated tools like ReplaceMagic reduce the risk of human error, ensuring links are updated correctly.
- Scalability: ReplaceMagic can handle large volumes of documents, making it suitable for enterprises and organizations with extensive data repositories.
- Seamless User Experience: By ensuring that links remain functional, ReplaceMagic preserves the user experience and minimizes disruption.
Conclusion
Migrating documents to the cloud is a critical step toward modernizing organizational infrastructure and improving operational efficiency. However, challenges such as broken links can hinder the success of such migrations. Tools like ReplaceMagic provide a comprehensive solution to this problem, offering automated link replacement, support for diverse file types, and robust reporting capabilities.
By leveraging ReplaceMagic, organizations can overcome the challenges of broken links and ensure a smooth, efficient, and error-free migration process. This not only saves time and resources but also enables businesses to fully realize the benefits of cloud-based document management systems. For organizations planning a cloud migration, incorporating tools like ReplaceMagic into their strategy is not just an option—it's a necessity for success.
For more information, visit www.replacemagic.com.
To download trial version of ReplaceMagic, go to www.replacemagic.com/downloads.aspx
To see pricing details, go to www.replacemagic.com/store.aspx
Document migration is a critical process in today’s digital workplace. Whether driven by IT upgrades, organizational restructuring, or compliance requirements, moving documents from one network share to another can create significant operational challenges. One such challenge is the proliferation of broken links when documents reference other files or resources that are relocated during migration. In this article, we’ll explore the impact of broken links on productivity and how tools like ReplaceMagic (www.replacemagic.com) can resolve these issues effectively, ensuring a seamless migration process.
The Need for Document Migration
Organizations rely heavily on network shares for storing and sharing critical business documents. However, over time, these shares can become outdated, inefficient, or vulnerable to security risks. Migration to a new network share offers several benefits:
-
Improved Security: Modern network shares often provide enhanced encryption and access control.
-
Cost Optimization: Consolidation of resources reduces storage costs and overhead.
-
Enhanced Performance: Upgraded hardware and infrastructure result in faster file access and better reliability.
-
Compliance: Migration ensures compliance with evolving data protection regulations.
Despite these advantages, document migration can disrupt workflows, especially when linked files are not properly updated to reflect the new structure.
The Challenge of Broken Links
During migration, documents often lose their connection to linked resources. These broken links can take various forms:
-
Hyperlinks in Documents: Links to external files or resources embedded in Word, Excel, PowerPoint, or other document formats.
-
Embedded Images and Media: Media files stored in a different location that the document references.
-
Dynamic Data Links: Excel formulas that pull data from other spreadsheets located in the original network share.
When these links break, it can have widespread consequences:
-
Loss of Productivity: Employees waste time searching for files or recreating links manually.
-
Operational Errors: Broken links can result in incorrect or incomplete data being used in decision-making processes.
-
User Frustration: A significant drop in user satisfaction occurs when previously seamless workflows are disrupted.
-
Compliance Risks: Missing or inaccessible files can lead to non-compliance with data retention policies or legal requirements.
Addressing Broken Links in Document Migration
To mitigate the impact of broken links, organizations need a structured approach:
1. Pre-Migration Analysis
Before initiating the migration, conduct a thorough audit of the existing network share:
-
Identify all documents and their dependencies.
-
Map out the relationships between files and linked resources.
-
Understand the scope and complexity of the migration task.
2. Define Migration Rules
Establish rules to manage file paths, naming conventions, and folder structures in the new network share:
-
Use consistent naming conventions to avoid confusion.
-
Implement a clear directory hierarchy that reflects business processes.
-
Plan redirects for essential links to ensure continuity.
3. Use Automation Tools for Link Fixing
Manual updates to links are impractical for large-scale migrations. Automation tools like ReplaceMagic (www.replacemagic.com) play a vital role in ensuring that links are updated correctly and efficiently.
How ReplaceMagic Can Help with Broken Links
ReplaceMagic is a powerful tool designed to streamline the process of updating links in documents after a migration. It automates the tedious and error-prone task of fixing links, ensuring a smooth transition to the new network share. Here’s how ReplaceMagic can help:
1. Comprehensive File Support
ReplaceMagic supports a wide range of file formats, including Microsoft Office documents (Word, Excel, PowerPoint), PDF files, and more. This ensures that links across different types of documents are updated without manual intervention.
2. Automated Link Updates
ReplaceMagic uses migration rules to identify and replace old file paths with new ones. For example:
-
Replace \\OldShare\Documents with \\NewShare\Documents.
-
Update links in embedded objects and formulas.
-
Ensure that hyperlinks in documents point to the correct location.
3. Bulk Processing
The tool can process hundreds or even thousands of files simultaneously, saving time and reducing the risk of errors. It also provides detailed reports, ensuring transparency throughout the process.
4. Customizable Migration Rules
ReplaceMagic allows organizations to define custom rules based on their specific migration needs. This flexibility ensures that all links are accurately updated, regardless of the complexity of the migration.
5. Preview and Validation
Before making changes, ReplaceMagic provides a preview of the updates. This allows IT teams to validate the changes and avoid unintended modifications.
6. Error Reporting and Troubleshooting
In the rare event of issues, ReplaceMagic provides detailed logs and error reports, making it easy to troubleshoot and resolve problems.
Benefits of Using ReplaceMagic for Document Migration
By leveraging ReplaceMagic, organizations can:
-
Save Time: Automating link updates drastically reduces the time required for migration.
-
Enhance Accuracy: ReplaceMagic eliminates human error in link fixing.
-
Maintain Continuity: Users can seamlessly access and use migrated documents without disruption.
-
Improve Compliance: Ensure that all links comply with regulatory requirements by maintaining accessibility and integrity.
-
Boost Productivity: Employees can focus on core tasks instead of troubleshooting broken links.
Implementing ReplaceMagic: A Step-by-Step Guide
Here’s a simple guide to using ReplaceMagic for document migration:
Step 1: Plan the Migration
Step 2: Install and Configure ReplaceMagic
Step 3: Define Migration Rules
Step 4: Run the Tool
Step 5: Validate Results
Step 6: Finalize and Document
Conclusion
Document migration from one network share to another is a necessary but complex process. Broken links can disrupt operations, reduce productivity, and increase compliance risks. However, tools like ReplaceMagic offer a reliable solution by automating the link-fixing process based on defined migration rules. By planning carefully and leveraging such automation tools, organizations can ensure a smooth and successful migration, maintaining business continuity and enhancing user satisfaction.
For more information, visit www.replacemagic.com.
To download trial version of ReplaceMagic, go to www.replacemagic.com/downloads.aspx
To see pricing details, go to www.replacemagic.com/store.aspx
Migrating documents from SharePoint On-Premises to SharePoint Online is a strategic move for businesses aiming to embrace cloud-based collaboration and scalability. However, one of the most persistent challenges in SharePoint document migration is the occurrence of broken links. When documents are transferred, embedded hyperlinks often lead to outdated paths, disrupting workflows and frustrating users. With tools like ReplaceMagic (www.replacemagic.com/downloads.aspx), organizations can efficiently fix broken links, ensuring a smooth migration process.
Challenges in SharePoint Migration
SharePoint On-Premises to SharePoint Online migration presents several hurdles:
- Broken Hyperlinks After Migration: Many documents contain internal and external links that no longer work after the migration.
- Complexity of Link Updates: Updating embedded links manually is time-intensive and prone to errors, especially in large-scale migrations.
- Throttling Issues: Microsoft enforces API throttling limits, which can delay migrations if not managed properly.
- Tracking Changes: Without proper reporting tools, ensuring that all links have been updated accurately is challenging.
Comprehensive Process for Document Migration and Fixing Links
1. Scanning Documents to Understand Current State
Before initiating a migration, it’s critical to analyze the documents in your SharePoint environment. ReplaceMagic simplifies this process by:
- Scanning documents for broken links: Identifying all files with embedded hyperlinks that might require updates.
- Generating detailed reports: Providing insights into the location and structure of links within the documents.
- Preparing for search-and-replace operations: Helping IT teams categorize and prioritize updates.
This step lays the foundation for efficient SharePoint Online link updates by creating a clear picture of the current state.
2. Preparing Search and Replace Strings
To fix hyperlinks in migrated documents, ReplaceMagic enables you to:
- Define search-and-replace strings: Locate outdated links using search patterns and create replacement strings aligned with new SharePoint Online URLs.
- Simulate link replacements: Test updates to ensure that link formatting and structure are preserved during the process.
Proper preparation is essential for successfully automating link updates in SharePoint Online, saving time and reducing manual errors.
3. Automating Link Updates
The complexity of fixing embedded links in documents is significantly reduced with ReplaceMagic:
- Update links in bulk: ReplaceMagic processes large volumes of documents simultaneously, ensuring efficiency.
- Automating link repair for SharePoint Online: The tool applies predefined search-and-replace strings to update all links in your migrated files accurately.
- Preserving document integrity: The tool ensures that the formatting and content of documents remain intact throughout the process.
4. Strong Reporting and Auditing for Link Updates
ReplaceMagic includes robust reporting capabilities that provide:
- Comprehensive migration tracking: Detailed logs document every link updated, ensuring transparency and accountability.
- Error identification: Highlighting unresolved links or failed updates for follow-up action.
- Auditing capabilities: Strong reporting tools ensure compliance with organizational standards and provide clear documentation of all changes made.
This level of detail simplifies post-migration analysis and gives stakeholders confidence in the success of the SharePoint document migration process.
5. Mitigating Throttling During Migration
Microsoft enforces API throttling limits to ensure system stability. ReplaceMagic addresses these limits by:
- Respecting Microsoft throttling guidelines: Managing API calls within the thresholds recommended by Microsoft.
- Smart protection mechanisms: Automatically pausing, slowdown and accelerate operations when throttling occurs, ensuring uninterrupted updates.
- Recommendation: Optimized scheduling: Allowing link updates during off-peak hours to minimize disruptions.
By mitigating throttling, ReplaceMagic ensures a consistent and efficient migration experience without delays.
Benefits of Using ReplaceMagic for SharePoint Migrations
- Efficiency: Automating link updates saves significant time compared to manual processes.
- Scalability: Handles large-scale migrations with ease, updating links in bulk for SharePoint Online.
- Transparency: Strong reporting tools track every change, providing clear insights and compliance documentation.
- User-Friendly: ReplaceMagic’s intuitive interface makes it easy for IT teams to fix broken links without advanced technical skills.
- Compliance: By adhering to Microsoft’s API throttling policies, ReplaceMagic ensures seamless migration operations.
Conclusion
Migrating from SharePoint On-Premises to SharePoint Online is a necessary step for businesses seeking to modernize their operations. However, addressing broken hyperlinks after migration is essential to maintaining productivity and collaboration. ReplaceMagic provides an efficient and scalable solution, from scanning documents for broken links to automating updates based on search-and-replace strings. Its robust reporting tools and compliance with Microsoft throttling guidelines ensure that migrations are both transparent and effective.
By leveraging ReplaceMagic, organizations can simplify the complexities of fixing embedded links in documents, update links in bulk, and ensure that their SharePoint Online environment is fully operational. Whether it’s tackling broken links or optimizing API usage, ReplaceMagic offers a comprehensive toolset for a smooth and successful SharePoint migration.
Download trial and test it yourself: www.replacemagic.com/downloads.aspx
All prices are visible over: www.replacemagic.com/store.aspx