Explanation

Moving/renaming a Page has some limitations, mainly affecting how references are updated to point to the new Page location.

• Image references are broken when contained in a renamed terminal Page
• Links inside macro content are only updated for macros whose content is explicitly declared as wiki syntax. As a result:
  • Links inside scripting macros (Velocity, Groovy, HTML with wiki syntax enabled, etc.) are not updated.
  • Macros that accept wiki syntax but do not declare it (e.g., built using older APIs) also do not have their links updated.
• Backlinks located inside macro content are not updated, unless the macro uses wiki syntax, or provides a dedicated MacroRefactoring implementation.
  • For example, a Java macro that stores a page reference in a parameter (e.g., page="Space.PageName") can implement MacroRefactoring to ensure that parameter is also updated when the referenced page is moved or renamed.

Related

• Limitations when Moving/Renaming a Page (for Administrators).