{"title":"Images Property","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/properties/devenv-images-property/","by":"JOP-AL","license":"Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/properties/devenv-images-property, MicrosoftDocs/dynamics365smb-devitpro-pb at 828b6ee (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/properties/devenv-images-property","source":{"name":"Business Central developer and IT pro docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-devitpro-pb","commit":"828b6ee72fcd75755627cd6011f3d20899217ab2","date":"2026-11-19"},"checked":"2026-11-19","description":"Specifies the list of images to include in the control add-in.","date":"2026-10-01","meta":{"topic":"reference"},"outline":[{"level":2,"title":"Applies to","slug":"applies-to","at":123,"chars":30},{"level":2,"title":"Property values","slug":"property-values","at":153,"chars":352},{"level":2,"title":"Remarks","slug":"remarks","at":505,"chars":796},{"level":2,"title":"Syntax example","slug":"syntax-example","at":1301,"chars":134},{"level":2,"title":"Image paths on control add-ins can be relative to the control add-in source file","slug":"image-paths-on-control-add-ins-can-be-relative-to-the-control-add-in-source-file","at":1435,"chars":1522},{"level":3,"title":"Organizing resources example","slug":"organizing-resources-example","at":2308,"chars":649},{"level":2,"title":"Related information","slug":"related-information","at":2957,"chars":76}],"text":"> Version: _Available or changed with runtime version 1.0._\nSpecifies the list of images to include in the control add-in.\n## Applies to\n Control Add In\n## Property values\nA list of comma-separated strings that represents paths to image files. The default is blank, with no images being used by the control add-in.\nYou can specify multiple files within the same path string by using a combination of a valid literal path and wildcard characters (* and ?). However, it doesn't support regular expressions.\n## Remarks\nThe Images property specifies image resources that are referenced by the control add-in scripts. Any specified images must be of a supported web format and extension, such as .PNG or .GIF.\nImages can be either external resources referenced using a URL or can be embedded within the extension. Embedded images must be added to the extension project folder in Visual Studio Code and referenced using a relative path. At runtime, the path to an embedded can be obtained using the ../methods/devenv-getimageresource-method method. Unlike scripts and stylesheets, images are loaded on demand when they're first used in code. Since images are stored in the application after the extension is deployed, it's recommended to keep the number of image files and combined image size to a minimum.\n## Syntax example\n```al\nImages = 'https://fabrikam.com/banner.png',\n              'images/map.png',\n              'images/*.png';\n```\n## Image paths on control add-ins can be relative to the control add-in source file\n> APPLIES TO: Business Central 2024 release wave 1 and later\nStarting from runtime 13, you can store control add-in resources in a location relative to the file that contains the source code of the control add-in. This provides more flexibility in organizing and locating control add-in resources.\nWhen the system needs to locate these resources, it follows a specific search order; first, it looks for the resources in a location relative to the root of the project. If the resources aren't found there, it then searches in a location relative to the source file of the control add-in.\nThe following example shows the two options for organizing control add-in resources; scripts, images, and stylesheets. For the file MyControlAddIn.al, the resources are organized in two different ways.\n### Organizing resources example\nFor the file MyControlAddIn.al.\n```al\ncontroladdin MyControlAddIn\n{\n    Scripts = './js/myscript.js';\n    Images = './png/myimage.png';\n    StyleSheets = 'css/mystyle.css';\n    ...\n}\n```\nThe resources are relative to the project root:\n```\n.\n[src]\n    MyControlAddIn.al\n[resources]\n    [js]\n        myscript.js\n    [png]\n        myimage.png\n    [css]\n        mystyle.css\napp.json\n```\nThe resources are relative to the control add-in source:\n```\n.\n[src]\n    MyControlAddIn.al\n    [resources]\n        [js]\n            myscript.js\n        [png]\n            myimage.png\n        [css]\n            mystyle.css\napp.json\n```\n## Related information\nControl add-in object<../devenv-control-addin-object>"}