{"record":{"id":"ee6d080bcd6149ad","repo":"Semantic-Org/Semantic-UI","slug":"allowing-user-additions-currently-requires-the-use","errorCode":null,"errorMessage":"Allowing user additions currently requires the use of labels.","messagePattern":"Allowing user additions currently requires the use of labels\\.","errorType":"console","errorClass":null,"httpStatus":null,"severity":"warning","filePath":"src/definitions/modules/dropdown.js","lineNumber":3795,"sourceCode":"  onShow        : function(){},\n  onHide        : function(){},\n\n  /* Component */\n  name           : 'Dropdown',\n  namespace      : 'dropdown',\n\n  message: {\n    addResult     : 'Add <b>{term}</b>',\n    count         : '{count} selected',\n    maxSelections : 'Max {maxCount} selections',\n    noResults     : 'No results found.',\n    serverError   : 'There was an error contacting the server'\n  },\n\n  error : {\n    action          : 'You called a dropdown action that was not defined',\n    alreadySetup    : 'Once a select has been initialized behaviors must be called on the created ui dropdown',\n    labels          : 'Allowing user additions currently requires the use of labels.',\n    missingMultiple : '<select> requires multiple property to be set to correctly preserve multiple values',\n    method          : 'The method you called is not defined.',\n    noAPI           : 'The API module is required to load resources remotely',\n    noStorage       : 'Saving remote data requires session storage',\n    noTransition    : 'This module requires ui transitions <https://github.com/Semantic-Org/UI-Transition>'\n  },\n\n  regExp : {\n    escape   : /[-[\\]{}()*+?.,\\\\^$|#\\s]/g,\n    quote    : /\"/g\n  },\n\n  metadata : {\n    defaultText     : 'defaultText',\n    defaultValue    : 'defaultValue',\n    placeholderText : 'placeholder',\n    text            : 'text',\n    value           : 'value'","sourceCodeStart":3777,"sourceCodeEnd":3813,"githubUrl":"https://github.com/Semantic-Org/Semantic-UI/blob/597843ab84d565cccfd8fd7719416350ae73e734/src/definitions/modules/dropdown.js#L3777-L3813","documentation":"restore.labels() runs during init/restore; if allowAdditions is true but useLabels is false, the combination is unsupported. The module logs this error and forcibly sets useLabels=true, so the dropdown keeps working but always in label mode.","triggerScenarios":"Configuring the incompatible pair { allowAdditions: true, useLabels: false } — you asked for free-text user additions but disabled the label rendering that additions require.","commonSituations":"Wanting a comma-delimited multiselect (useLabels:false) together with allowAdditions:true; these are mutually exclusive in this version.","solutions":["Keep useLabels:true (the default) whenever allowAdditions:true","If you need useLabels:false, set allowAdditions:false"],"exampleFix":"// before\n$('.ui.dropdown').dropdown({ allowAdditions: true, useLabels: false });\n// after\n$('.ui.dropdown').dropdown({ allowAdditions: true, useLabels: true });","handlingStrategy":"validation","validationCode":"function validDropdownConfig(cfg) {\n  cfg = cfg || {};\n  if (cfg.allowAdditions === true && cfg.useLabels === false) {\n    throw new Error('allowAdditions:true requires useLabels:true');\n  }\n  return cfg;\n}\n$('.ui.dropdown').dropdown(validDropdownConfig({ allowAdditions: true, useLabels: false }));","typeGuard":"function isConsistentDropdownConfig(c) {\n  return !(c && c.allowAdditions === true && c.useLabels === false);\n}","tryCatchPattern":null,"preventionTips":["Never combine allowAdditions:true with useLabels:false — pick one mode","Centralize dropdown option construction in a factory that asserts the invariant","Document the chosen multiselect mode in your component wrapper"],"tags":["dropdown","semantic-ui","config","multiselect"],"backgroundTag":null,"analyzedSha":"597843ab84d565cccfd8fd7719416350ae73e734","analyzedAt":"2026-08-13T01:44:23.827Z","schemaVersion":2},"datasetVersion":"2026-08-13T04:17:16.726Z"}