Reference
Element options
Exhaustive constructor option reference for XLQP Gen1 elements and factory methods.
Element options
This page lists the accepted configuration fields for every canonical XLQP Gen1 element constructor. All fields are optional unless your use case requires them. Field names are case-sensitive; compatibility aliases may exist, but the names below match the current UI source and full example.
How to use this reference
Find the method, choose only the fields you need, and pass them in one table. Use the full example to see the fields combined in a real script.
local Control = Section:AddToggle({
Name = "Enabled",
Default = false,
Flag = "enabled",
Save = true,
Callback = function(value)
print(value)
end,
})Input and action
| Method | Accepted configuration fields |
|---|---|
AddButton | Callback, Icon, Image, Locked, Moveable, Name, Premium |
AddSmoothToggle | Callback, Color, Content, Default, Description, Flag, LiveColor, LiveColorSpeed, LiveColorTheme, LiveColors, Name, Save |
AddToggle | Binded, Callback, Checkbox, Color, ConfigCloud, ConfigCloudAutoSend, ConfigCloudKey, Content, Default, DefaultBind, Description, Flag, Icon, IconSize, Locked, Moveable, Name, Premium, Save, Settings |
AddSlider | Callback, Color, Color2, Content, Default, Description, DisplayFormattedInput, Flag, FormatValue, Increment, Input, Locked, Max, Min, Moveable, Name, ParseValue, Premium, Save, Smooth, TextBox, ValueName |
AddDropdown | Advanced, AdvancedDrop, Callback, Default, Fill, FillColor, FillTransparency, Flag, Image, Locked, MaxElements, Moveable, MultiSelect, Name, Options, Outline, OutlineColor, Players, Premium, PVP, Save, Search, Whitelist |
AddBind | Callback, Default, Flag, Hold, Image, Locked, Name, Save, UIBind |
AddKeyPicker | Callback, Default, Flag, Hold, Image, Locked, MenuVisible, Name, Save, UIBind |
AddTextbox | Ai, Callback, Default, Flag, Gui, Locked, Moveable, Name, Placeholder, Save |
AddTextArea | Callback, Content, Default, Description, Height, Moveable, Name, Placeholder |
AddColorpicker | Alpha, Callback, Default, Flag, Image, Live, LiveDelay, Locked, Name, Save, ThemePicker, Transparency |
AddCooldownButton | ActionText, ButtonText, Callback, Color, Cooldown, CooldownText, Desc, Description, Duration, Name |
AddStepper | Callback, Default, Increment, Max, Min, Name |
AddChecklist | Callback, Items, Name |
AddQuickToggleRow | Callback, Default, Items, Name, Options |
AddCommandBar | ButtonText, Callback, Default, Name, Placeholder |
AddActionRow | Buttons, Moveable, Name, Outline, OutlineColor |
AddMiniButtons | Buttons, Name |
Text, status, and layout
| Method | Accepted configuration fields |
|---|---|
AddSection | Name, Title |
AddBoxSection | Content, DefaultOpen, Description, Name, Title |
AddLabel | BackgroundTransparency, Content, DoesWrap, Font, Icon, Image, IsRich, Name, RichText, Size, Text, TextSize, TextXAlignment, TextYAlignment, Visible, Wrap |
AddParagraph | Color, Content, DoesWrap, DontAskAgain, ImageSize, Locked, Name, Premium, RichText, UserProfile, discordpar, image, opena |
AddCode | Content, Description, Language, Name, response, src |
AddDependencyBox | BackgroundTransparency, Dependencies, Dependency, Element, Equals, Invert, Mode, Name, Operator, Predicate, Value |
AddLog | DoesWrap, IsRich, RichText, Size, Text |
AddBadge | Color, Content, Name, Text |
AddInfoCard | Color, Content, Description, Icon, Image, Name |
AddStatCard | Desc, Description, Name, Value |
AddNotice | Color, Content, Name, Text |
AddStatusDot | Color, Content, Description, Name |
AddStatusBox | Content, Description, Height, Icon, Kind, Message, Name, Status, Text, Title, Type, Variant |
AddBanner | ActionCallback, Actions, BackgroundImage, Callback, Content, Description, Height, Icon, Image, ImageTransparency, Name, ShadeTransparency, Title |
AddCopyBox | Callback, Content, Name, Text |
AddShortcutHint | Bind, Content, Description, Key, Name |
AddKeyValueList | Items, Name |
AddTimeline | Color, Items, Logs, Name |
AddChangelog | Content, Height, Items, Logs, Name |
AddFilterList | Callback, Height, Items, Name, Placeholder |
AddTagCloud | Height, Items, Name, Tags, TagWidth |
AddPillList | Height, Items, Name, Tags, Width |
AddToastAction | ButtonText, Callback, Content, Description, Image, Name, Notification, NotifyText, Time |
AddNotify | ButtonText, Buttons, Callback, Content, Description, Icon, Image, Name, NotifyContent, NotifyName, Pos, Seconds, Time |
AddDivider | Name |
AddSpacer / AddSpace | Height, Size |
Data and monitoring
| Method | Accepted configuration fields |
|---|---|
AddDataTable | Callback, Columns, EmptyText, Height, Name, RowHeight, Rows, SearchPlaceholder, Searchable |
AddTableContents | Columns, ConfigCloud, ConfigCloudKey, Content, Description, Height, Name, RowHeight, Rows, Title |
AddProgressBar | Color, Default, Desc, Description, Max, Min, Name, Value |
AddRuntimeMonitor | AutoStart, Interval, Metrics, Name |
AddMeterGroup | Color, Items, Name |
AddLoadoutGroup | ButtonText, Callback, Color, EquipCallback, Font, Icons, Items, Name, OnEquip, OnSelect, Title |
AddRevenueCard | Callback, Change, Color, Decimals, Duration, Icon, Image, Items, MiniStats, Name, Prefix, StartValue, Stats, Suffix, Trend, Value |
AddPlayerCount | Description, Name |
AddClock | Description, Format, Name |
AddPlayerVisualizer | BoxCallback, Boxes, Callback, Height, LiveColor, LiveColorSpeed, Name, Player |
AddKeybindList | Detached, DockHeight, Height, Icon, Pin, Popout, PopoutPosition, Title, Width |
Media and visual tools
| Method | Accepted configuration fields |
|---|---|
AddImage | Asset, BackgroundTransparency, Color, Height, Image, Name, ScaleType, Transparency |
AddVideo | Asset, Height, Looped, Name, Video, Volume |
AddMediaPlayer | AutoPlay, Callback, Default, Loop, Name, NotifySupport, Pitch, Playlist, Visualizer, VisualizerBars, VisualizerHeight, Volume |
AddDiscPlayer | AutoPlay, Loop, MediaPlayer, Name, Playlist, Position, SpinSpeed, Volume |
AddBytebeat | Default, DefaultPreset, Duration, Hz, HzIncrement, MaxDuration, MaxHz, MaxSeconds, Mode, Name, Pitch, Playlist, Seconds, Speed, Visualizer, VisualizerBars, VisualizerHeight |
AddDrawingGrid | BoxHeight, BoxWidth, Boxes, BrushSize, Callback, CellHeight, CellWidth, Color, Columns, Height, Name, Rows |
AddViewport | AutoFocus, BackgroundTransparency, Camera, Clone, Height, Instance, Interactive, Model, Name, Object, Visible |
AddPassthrough / AddUIPassthrough | Height, Instance, Name |
Navigation and containers
| Method | Accepted configuration fields |
|---|---|
MakeTab | AutoHome, Changelog, DiscordInvite, FeedbackWebhook, Group, GroupIcon, Icon, Name |
newmaketabtop / AddTopTab | Effects, flames, MultiTab, Name |
AddTabbox | IconOnly, Name, TabSize |
AddLeftTabbox / AddRightTabbox | Name, TabSize |
AddLeftGroupbox / AddRightGroupbox | title, icon |
AddLeftSidebarMenu / AddRightSidebarMenu | CloseOnOutside, Detached, DimBackground, Gap, Height, Icon, MaxHeight, MaxWidth, MinHeight, MinWidth, Name, Resizable, Width |
AddDropdownPanel | Name, Open, Title |
Advanced and integrations
| Method | Accepted configuration fields |
|---|---|
AddDebugConsole | AutoScroll, Callback, CaptureOutput, CaptureRoblox, Default, Height, Lines, MaxLines, Messages, Name, OnLog, TextSize, Title |
AddGameSession | AutoExecFile, AutoExecFolder, AutoExecName, AutoExecute, AutoExecuteFile, AutoExecuteSource, AutoExecuteUrl, AutoReExecute, GameIds, Games, Height, HistoryFile, HistoryLimit, IdType, Name, OnJoin, OnLeave, OnRejoin, OnServerHop, QueueSource, ReExecuteSource, ReExecuteUrl, SourceUrl, SupportedGameIds |
AddScriptHub | Collapsed, Description, Icon, ImageCacheFolder, MaxResults, Name, Order, SortBy, Strict |
AddGlobalChat | AppId, BotID, BotId, ConversationFile, DisclaimerFile, DisclaimerText, Height, Limit, MaxMessageLength, MessageLength, Name, NotifyPos, PVP, Pos, RefreshTime, ReportCooldown, Rules, SendCooldown, SystemId |
AddDiscordImg | Content, DontAskAgain, Invite, InviteCode, Name, OpenMode, RememberOpenMode, discordpar |
AddStudioTool | Anchored, ButtonColor, Callback, CanCollide, Color, Content, Default, Description, Grid, MeshId, Name, ParentPath, PartSize, PartType, Path, TargetPath, TextureId |
AddSoccer | AutoRefresh, Callback, Height, League, LeagueOrder, Leagues, Moveable, Name, RefreshTime, ShowLogos |
AddPlugins | AllowInline, AllowRemote, AutoLoad, Folder, Name, RemotePlugins, SaveInline, URLs |
AddXLQPGen1AI | Ai, BubbleResponses, ChatPromptsOnly, CompanionEnabled, CompanionName, Default, FollowDistance, FollowEnabled, Gui, Height, LayoutOrder, Moveable, Name, ThemeToolsEnabled, UltraAI, UsePlayerAnimations, WalkSpeed, WorldToolsEnabled |
AddExecutor | Default, Height, MetaTextSize, Name, TextSize, TitleTextSize |
AddNametags | Callback, Content, Default, Health, Name, PreviewName, ShowDecimal, ShowDistance, ShowHealth |
AddFriends | Name |
Factory methods
| Method | Accepted configuration fields |
|---|---|
CreateCheckbox | Callback, CurrentValue, Description, Flag, Name, Save |
CreateProgress | Callback, CurrentValue, Description, Flag, Icon, Max, Min, Name, Save, Suffix |
CreateProgressBar | Callback, CurrentValue, Description, Max, Min, Name, Suffix, ValueText |
CreateDownloadProgress | Callback, Completed, CurrentValue, Description, Duration, Name |
CreateCopyButton | Callback, Description, Icon, Name, Value |
CreateFlipButton | Back, Callback, Front |
CreateRippleButton | Callback, Description, Name |
CreateScrollHint | AutoScroll, AutoStart, Callback, Icon, ScrollAmount, Text |
CreatePinnedList | Callback, Items, PinnedTitle, Title |
CreateCursorTag | Callback, Height, Hint, Text |
CreateChart | Callback, Color, Dots, Filled, Height, Icon, MaxPoints, Name, Points, Prefix, Smooth, Suffix |
CreateBarChart | Callback, Icon, Name, Points |
CreateStackedChart | Callback, Icon, Name, Prefix, Rows, Series |
CreateStat | Callback, Delta, Duration, Icon, Name, Value |
CreateFAQ | Callback, Exclusive, Items, Name |
CreateMediaPlayer | AutoPlay, Callback, Default, Loop, Name, NotifySupport, Pitch, Playlist, Preset, Visualizer, VisualizerHeight, Volume |
CreateBytebeat | Callback, Default, Hz, MaxSeconds, Mode, Name, Pitch, Playlist, Seconds, Speed, Visualizer, VisualizerHeight |
CreatePopup | Description, Options, Title |
Shared conventions
In addition to the constructor-specific fields above, registered elements can use TextColor, Style, and LockedTo. Supported interactive surfaces may also use CursorGlow, CursorGlowColor, CursorGlowSize, and CursorGlowStrength. See New window and runtime APIs for examples and parameter-introspection helpers.
| Field | Meaning |
|---|---|
Name | Visible title or identifier |
Description / Content | Supporting copy |
Default | Initial value |
Callback | Function called after user interaction |
Flag | Stable key used by configuration saving |
Save | Saves a supported element when window config is enabled |
Locked | Prevents interaction |
Moveable | Allows movement when editable elements are enabled |
Premium | Applies premium/locked presentation where supported |
Icon / Image | Icon name, asset ID, or supported image value |
Height / Width | Explicit dimensions |
Color | Accent or content color |
See All elements for descriptions and compatibility aliases, and Controllers for returned runtime methods.
October 2026 additions
The following fields supplement the earlier constructor tables. See Current API additions, AI agent, and Key system for examples, types, defaults, nested fields, and controllers.
| Constructor | New or expanded accepted fields |
|---|---|
AddSubTabs | Name, Title, Height, Fill, Gap, ButtonHeight, Color, Accent, Callback |
AddSubTab / SubTabs:AddTab | Name, Title, Icon, Image, Width, Selected, Default, TabAccent, Color, Accent, BackgroundColor, ButtonColor, BaseColor, BackgroundImage, TabImage, CardImage, ButtonImage, ImageColor, TabImageColor, BackgroundImageColor, ImageTransparency, TabImageTransparency, BackgroundImageTransparency, SelectedImageTransparency, ImageScaleType, ForceColumns, Columns, TwoColumn; automatic-manager seed Height |
AddOptionGrid | Name, Title, Options, Default, Value, Multi, MultiSelect, Rows, Height, Width, Custom, CardWidth, CardHeight, Spacing, Columns, Icon, HeaderIcon, SettingsIcon, ShowHeaderIcon, ShowSettingsButton, ShowSettingsSummary, Flag, Save, Callback |
AddElementGrid / AddWidgetGrid | Name, Title, Height, Width, Custom, Rows, Columns, CellWidth, CellHeight, Spacing, AutoHeight, MinHeight, MaxHeight, Elements |
AddSlider / AddCustomSlider | Parameters, Points, Stops, Modes, ShowDots, ParameterArrow, ShowParameterDescription, DotSize, ActiveDotSize, KnobWidth, KnobHeight, Preset, StylePreset, AllowSmall, AllowMini, Style, CustomStyle, Plugin, CustomPlugin, SliderPlugin, FormatParameter |
AI AddTextbox / AddXLQPGen1AI | Height, PermissionMode, Effort, AgentPlanner, WorkspaceTools, ShowContextDetails, MultilineInput, PromptTransform, OnResponse |
AddBytebeat | Looped, Cache, FrameBudget, WriteBlock |
The constructor implementations accept more aliases and nested values than the bundled parameter-example registry lists. When those differ, use the dedicated guide and the implementation, rather than treating registry example strings as guaranteed defaults.