Known issues

Last modified by Lucas Charpentier on 2026/10/13 12:21

These are the JIRA issues reported before the audit that are about inserting, configuring or editing the audited macros, sorted by the macro they affect. Check them before reporting a KO, so that no duplicate is created: the audit of each macro also suggests the ones that match its KOs.

The issues come from searches of jira.xwiki.org and from the issues already cited in this proposal. Each issue is a Known Issue object of this page: to change how an issue is sorted, edit its object in the object editor. The audit process explains how to run the searches again.

Information

69 issues affect every macro, and 33 macros have issues of their own. An issue that affects several macros is listed under each of them. 0 issues are still to sort, and 187 issues found by the searches are not about usability: they are kept so that the searches do not suggest them again.

All macros

Issues of the macro system, the WYSIWYG editor or the Edit Macro dialog, which affect every macro.

IssueTitleStatusCriteriaAlso affects
CKEDITOR-115Broken styling for XWiki macros when hitting Back buttonOpenE1
CKEDITOR-227Exception when saving a document in which a macro call was cut and pasted and changes are lostOpen
CKEDITOR-246Macro Content Prefill removes all formatting of selected textOpen
XRENDERING-79Add documentation url in macro descriptorOpenL2
XRENDERING-435Macro error message customizationOpenE2
XRENDERING-638Macros cannot be initialized with a default content in javaOpenI2
XRENDERING-720Make macro execution exceptions translatableOpenE2
XRENDERING-748A macro with a null descriptor completely breaks the macro picker (NPE)Reopened
XRENDERING-750The empty lines before an inline editable macro are removedOpen
XRENDERING-782Log a warning whenever a deprecated macro parameter is usedOpenC9
XWIKI-4448Show a link towards documentation in macro insertion dialogOpenL2
XWIKI-6061Add macro parameter display name support to wiki macrosOpenC1
XWIKI-7569Grey out editing icons that cannot be used when the cursor is on a macro contentOpenE3
XWIKI-8967Wrong view position after editing a macroClosed
XWIKI-11702Editing a Macro that doesn't exist shouldn't generate exceptions in the console when using the WYSIWYG editorOpenE2
XWIKI-12755Built-in macros : provide documentation help link from editing pageOpenL2
XWIKI-15969Make it easier to write wiki-based rendering macros that are editable inlineOpenE6
XWIKI-16348Provide a simple way to package together a wiki macro and the pickers needed for its parametersOpenC4
XWIKI-16467Default value of mandatory macro parameter cannot be used in WYSIWYG editorOpenC2, C3
XWIKI-16916Wiki macros still remove MacroMarkerBlock when they are inline editableOpenE6
XWIKI-16934Page picker doesn't allow easily selecting a page when a lot of pages matchOpenC4
XWIKI-17417Wiki macro content cannot be inline edited in the WYSIWYG when the macro is not standaloneOpenE6, E4
XWIKI-17503In existent macro parameter type class causes macro to be invisble from the macro pickerOpen
XWIKI-18595Suggest pickers (user, group, page, etc.) should indicate if there are more results than the ones displayedOpenC4
XWIKI-19738Macros uninstalled through EM are still displayed as installed in WYSIWYG macros pickerOpen
XWIKI-19863The Available Macros does not show overridden categoriesOpenD3
XWIKI-19954Add support for editing the macro content in-place for non-standalone macrosOpenE6
XWIKI-19985Add icons in the Macro selectorOpen
XWIKI-20140Give more control on the serialization of macro parameter of type enumOpenC4
XWIKI-20230CKEditor macro dialog filtering should also include technical nameOpenD4
XWIKI-20632Page searched by its exact name is not found in a page picker for a macro parameter when its subtree is larger than 10 pagesClosedC4
XWIKI-20751Add a displayer for SpaceReference parametersOpenC4
XWIKI-20802Macro parameter of type Date not showing any resultOpenC4
XWIKI-21063Allow macros to opt-out from WYSIWYG quick actionsOpenI3
XWIKI-21100The name of the macro should be prioritized when filtered in Select Macro modalOpenD4
XWIKI-21233Allow hiding non installed macrosOpen
XWIKI-21362Allow 'Edit Macro' dialog to be opened by default when a macro that needs configuration is inserted through Quick ActionsOpenI5display
XWIKI-21596Missing translation key for some quick actionsOpenD1
XWIKI-21981Translate the macro editor dialog UIOpenC1
XWIKI-22046Visible output macros with blank outputs do not get a placeholder or existence indicator in the editorOpenE1
XWIKI-22225When wrapping text in a macro in WYSIWYG, the formatting is lostOpen
XWIKI-22289Don't show macros for which users don't have the rights to executeOpen
XWIKI-22349Sometimes Macro insertion eats what comes nextOpen
XWIKI-22384Use a different decoration for macro boundary vs. macro content boundary, for macros with content editable in the wysiwyg editorOpenE6
XWIKI-22473Missing semantics in the structure of the option groups in the slash-dropdownOpenD4
XWIKI-22493Quick action dropdown is not read properly when navigatedOpenD4
XWIKI-22850Add an option in a macro parameter to select the page/space for attachment suggestionsOpenC4
XWIKI-22914Display a placeholder text if no attachment is present on the page when using the attachment selector in a macro modalOpenC4
XWIKI-22915When using the attachment selector in a macro modal, prefill the name parameterOpenC4
XWIKI-23020Add documentation column in the syntax guide for macrosOpenL2
XWIKI-23045Allow to define a provider of values for a macro parameterOpenC4
XWIKI-23059Can't set a custom displayer for macro content in CKEditor's macro editorOpenC4
XWIKI-23309Cannot edit inline macro content when the macro is in a table cellOpenE3
XWIKI-23501Block macros are broken in tables and listsOpenE3
XWIKI-23759Provide custom placeholders in macro configuration inputsOpenC3
XWIKI-24083The order of the parameter groups can not be specified for xobject macrosOpenC5
XWIKI-24149Allow to define a resolution order between feature and group for macroOpenC7
XWIKI-24289The name of a macro parameter which is part of a @PropertyFeature is duplicated in the displayerOpenC7
XWIKI-24355Macro editor localization is partially offOpenC1
XWIKI-24784The macro editor displays the raw parameter feature id as a group heading instead of a translated nameOpenC7
XWIKI-24845Display a live preview of the macro output in the macro configuration dialogOpen
XWIKI-25173Show whether a macro supports inline mode in the Quick Actions macro listOpenE4
XWIKI-25174Show whether a macro supports inline mode in the Insert Macro and Edit Macro dialogsOpenE4
XWIKI-25180Allow macro parameters to declare that they depend on another parameterOpenC5
XWIKI-25181Don't show macro parameters that the current user doesn't have the rights to useOpenC9
XWIKI-25182Numeric macro parameters accept any text in the Edit Macro dialogOpenC13
XWIKI-25183Allow the page and attachment pickers to reject references to entities that don't existOpenC4
XWIKI-25197Allow wiki macro parameters to declare a range or a format for their valueOpenC13
XWIKI-25234Submitting the macro dialog with an empty required parameter displayed with a suggest picker gives no visible feedbackOpenE2

async

Audit of the async macro

IssueTitleStatusCriteriaAlso affects
XWIKI-23032Async macro editor: Description of `async` parameter should be improvedOpenC1
XWIKI-23033Async macro editor: Description of `context` parameter must be improvedOpenC1
XWIKI-23034Async macro WYSIWYG:By default, the async block is invisible in the editorOpenE5
XWIKI-23035Async macro editor: The content cannot be edited in the MacroEditor.OpenL1
XWIKI-23947Async rendering should be disabled when the WYSIWYG editor doesn't load JavaScript skin extensionsOpenE1

attachmentGalleryPicker

Audit of the attachmentGalleryPicker macro

IssueTitleStatusCriteriaAlso affects
XWIKI-23036AttachmentGalleryPicker macro WYSIWYG: The buttons in the picker should not be interactable in edit modeOpenE1

attachmentSelector

Audit of the attachmentSelector macro

IssueTitleStatusCriteriaAlso affects
XWIKI-23037AttachmentSelector macro Editor: The picker for the property `object` should be more specificOpenC4
XWIKI-23038AttachmentSelector macro Editor: The picker for the property `savemode` should be more specificOpenC4
XWIKI-23039AttachmentSelector macro Editor: The picker for the property `defaultValue` should be more specificOpenC4

box

Audit of the box macro

IssueTitleStatusCriteriaAlso affects
CKEDITOR-266Hidden 'Content' parameter for 'Box' macro after pressing 'Change Macro' buttonOpenC6
CKEDITOR-296Cannot remove the box macro title once setOpen
CKEDITOR-375Editing the home page shows a not rendered box macroOpenE1
XWIKI-22863Deprecate box macro image supportOpenC9
XWIKI-24152Add a placeholder to the Box MacroOpenE5

chart

Audit of the chart macro

IssueTitleStatusCriteriaAlso affects
XWIKI-16040The Chart macro doesn't have good default values for its parametersOpenC3

chartjs

Audit of the chartjs macro

IssueTitleStatusCriteriaAlso affects
CHARTJS-38A blank block is displayed if the content json is malformedOpenE2

children

Audit of the children macro

IssueTitleStatusCriteriaAlso affects
XWIKI-23142Rendering error is not clear when inserting a wrong Root parameter in Children Macro and Page Tree MacroOpenE2documentTree

code

Audit of the code macro

IssueTitleStatusCriteriaAlso affects
XRENDERING-773Leading and final new lines should not be discarded from inline macro contentReopenedE4
XWIKI-17167Code Macro Edit Dialog Should Better Document Supported LanguagesOpenC4
XWIKI-19978"Code" Macro Should Support Inline EditingOpenE6
XWIKI-22210Blocks of {{code}} are acting strangeOpen
XWIKI-22832Display line numbers when editing code macroOpenE6

content

Audit of the content macro

IssueTitleStatusCriteriaAlso affects
XRENDERING-550Provide good defaults for the 'Content' macro parametersOpenC3
XWIKI-16048List the available syntaxes in the Content macro's parameters modalOpenC4

context

Audit of the context macro

IssueTitleStatusCriteriaAlso affects
XWIKI-15190Raise an error when the {{context}} macro is used inline but produces non inline BlocksOpenE4

dashboard

Audit of the dashboard macro

IssueTitleStatusCriteriaAlso affects
XWIKI-6138Add Gadget dialog add gadget title field on top of the macro descriptionOpenC6
XWIKI-20634Suggestions of the page picker in macro parameters display under the modal when used on the dashboard editorOpenC4include

display

Audit of the display macro

IssueTitleStatusCriteriaAlso affects
XWIKI-13997Page/editor corruption caused by inlined display/include macro that references block contentOpenE4include
XWIKI-21362Allow 'Edit Macro' dialog to be opened by default when a macro that needs configuration is inserted through Quick ActionsOpenI5all macros
XWIKI-22690Translation keys missing for macro ‚display‘ and ‚include‘OpenC1include

displayIcon

Audit of the displayIcon macro

IssueTitleStatusCriteriaAlso affects
XWIKI-20875Icon macro should use a list of existing Icon sets as parameter instead of inputOpenC4
XWIKI-23787Remove the quick action for the displayIcon macroOpenD4

documentTree

Audit of the documentTree macro

IssueTitleStatusCriteriaAlso affects
XWIKI-23026Error when sorting by "Creation date" or "Last modification date" in Document Tree macro that prevents displaying the documentsOpenE2
XWIKI-23142Rendering error is not clear when inserting a wrong Root parameter in Children Macro and Page Tree MacroOpenE2children
XWIKI-24713Small misalignment still present on the document picker on Page Tree macroOpenC4

documents

Audit of the documents macro

IssueTitleStatusCriteriaAlso affects
XWIKI-13363Remove deprecated macro parameters from the Wysiwyg macro wizardOpenC9include

error

Audit of the error macro

IssueTitleStatusCriteriaAlso affects
XWIKI-22028CKEditor / Xwiki 2.1 Syntax: Multi-paragraph Highlighting BoxesOpeninfo, warning, success
XWIKI-23623Table cell actions not available in WYSIWYG when inside macro with in-line editable contentOpenE3info, warning

example

Audit of the example macro

IssueTitleStatusCriteriaAlso affects
XWIKI-25018The example macro from the Help application should be internal and fixedOpenD3

figure

Audit of the figure macro

IssueTitleStatusCriteriaAlso affects
CKEDITOR-250Cannot remove extra new lines when editing macro inlineOpenE6
XFIGURE-3Make the figure and figure caption identifiable in edit modeOpenE1

footnote

Audit of the footnote macro

IssueTitleStatusCriteriaAlso affects
XRENDERING-784Allow macros to indicate their preferred modeOpenE4

gallery

Audit of the gallery macro

IssueTitleStatusCriteriaAlso affects
XWIKI-23735Provide an image picker for the Gallery macro when used in WYSIWYGOpenC4

groovy

Audit of the groovy macro

IssueTitleStatusCriteriaAlso affects
XWIKI-19035Groovy Macro Content field appears to be mandatory only on CKEditor UI edit modeOpenC2

html

Audit of the html macro

IssueTitleStatusCriteriaAlso affects
XWIKI-19950Make the HTML macro editable inlineOpenE6

include

Audit of the include macro

IssueTitleStatusCriteriaAlso affects
XRENDERING-49Include macro within a box macro doesn't show the page as "included"OpenE1
XRENDERING-517Invalid HTML generated when a macro that is called inline produces block level contentOpenE4
XWIKI-13363Remove deprecated macro parameters from the Wysiwyg macro wizardOpenC9documents
XWIKI-13997Page/editor corruption caused by inlined display/include macro that references block contentOpenE4display
XWIKI-20634Suggestions of the page picker in macro parameters display under the modal when used on the dashboard editorOpenC4dashboard
XWIKI-20944Include macro fails to execute when no reference is specifiedClosedC7
XWIKI-22690Translation keys missing for macro ‚display‘ and ‚include‘OpenC1display

info

Audit of the info macro

IssueTitleStatusCriteriaAlso affects
CKEDITOR-267Content gets duplicated for macros that can be inline edited, after deleting and undoing the deletion of contentOpenE5
XWIKI-19959Selecting some text and clicking Insert > Info Box Macro should put the selected content in the macro contentOpen
XWIKI-22028CKEditor / Xwiki 2.1 Syntax: Multi-paragraph Highlighting BoxesOpenwarning, error, success
XWIKI-23623Table cell actions not available in WYSIWYG when inside macro with in-line editable contentOpenE3warning, error

jira

Audit of the jira macro

IssueTitleStatusCriteriaAlso affects
JIRA-37Add ability to add a default Jira instanceOpenC3
JIRA-41Improve error reporting when the API fails to parse the returned content properlyOpenE2
JIRA-45Jira Macro doesn't render the first time edit mode is enteredOpenE1
JIRA-69Provide default message when no issues are foundOpenE2
JIRA-80Introduce a custom JIRAServer (instance id) dispalyerOpenC4
JIRA-95Jira macro inside list field does not display error in view mode due to async rendering differenceOpenE2
JIRA-111Paste feature does not work if JIRA instance URL configured in Administration contains a slash at the endOpen
JIRA-113Paste feature does not work if JIRA links are pasted by regular (non-admin) usersOpen
JIRA-122The parameters Macro parameter silently mis-parses any separator other than a commaOpenC4
JIRA-125Display a user-friendly message when the JIRA server is unavailableOpenE2
XWIKI-23320Some macro output is hidden when editing themOpenE1

mention

Audit of the mention macro

IssueTitleStatusCriteriaAlso affects
XWIKI-20158Mention Macro is placed at the beginning of the line when inserted in-line on SafariOpen

notifications

Audit of the notifications macro

IssueTitleStatusCriteriaAlso affects
XWIKI-23835Reduce the amount of items visible on the notification macro editOpenC5

office

Audit of the office macro

IssueTitleStatusCriteriaAlso affects
XWIKI-23503'Submit' button is active although no document is uploaded in the Office Document Viewer MacroOpenC2

putFootnotes

Audit of the putFootnotes macro

IssueTitleStatusCriteriaAlso affects
XWIKI-5713WYSIWYG section editing add  {{putFootnotes/}} in section if a document with footnotes is includedReopened

success

Audit of the success macro

IssueTitleStatusCriteriaAlso affects
XWIKI-22028CKEditor / Xwiki 2.1 Syntax: Multi-paragraph Highlighting BoxesOpeninfo, warning, error

tagcloud

Audit of the tagcloud macro

IssueTitleStatusCriteriaAlso affects
XWIKI-17818The Tag Cloud Macro should use "page" and "pages" parametersOpenL1

warning

Audit of the warning macro

IssueTitleStatusCriteriaAlso affects
XWIKI-22028CKEditor / Xwiki 2.1 Syntax: Multi-paragraph Highlighting BoxesOpeninfo, error, success
XWIKI-23623Table cell actions not available in WYSIWYG when inside macro with in-line editable contentOpenE3info, error

wikimacrocontent

Audit of the wikimacrocontent macro

IssueTitleStatusCriteriaAlso affects
XWIKI-24905Empty {{wikimacrocontent/}} fails to render/editOpenE5

Get Connected