{"title":"Benefits and guidelines for using a prefix or suffix","url":"https://jonas-paprotka.de/docs/dev-itpro/compliance/apptest-prefix-suffix/","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/compliance/apptest-prefix-suffix, 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/compliance/apptest-prefix-suffix","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":"Use a prefix or suffix for names in your extension. This rule applies to all objects, including tables, pages, and codeunits. This topic explains the benefits and guidelines for using a prefix or suffix.\"","date":"2023-04-11","meta":{"topic":"how-to"},"outline":[{"level":1,"title":"Benefits and guidelines for using a prefix or suffix","slug":"benefits-and-guidelines-for-using-a-prefix-or-suffix","at":0,"chars":7327},{"level":2,"title":"Benefits","slug":"benefits","at":484,"chars":332},{"level":2,"title":"General rules","slug":"general-rules","at":816,"chars":1147},{"level":2,"title":"Affixes requirements for extensions","slug":"affixes-requirements-for-extensions","at":1963,"chars":1946},{"level":3,"title":"For Marketplace extensions","slug":"for-marketplace-extensions","at":2002,"chars":1480},{"level":3,"title":"For per-tenant extensions","slug":"for-per-tenant-extensions","at":3482,"chars":427},{"level":2,"title":"Examples of objects with affixes or namespaces","slug":"examples-of-objects-with-affixes-or-namespaces","at":3909,"chars":1384},{"level":3,"title":"Table","slug":"table","at":4130,"chars":279},{"level":3,"title":"Page","slug":"page","at":4409,"chars":275},{"level":3,"title":"Page extension objects","slug":"page-extension-objects","at":4684,"chars":420},{"level":3,"title":"Codeunit","slug":"codeunit","at":5104,"chars":189},{"level":2,"title":"Examples - per-tenant extension","slug":"examples---per-tenant-extension","at":5293,"chars":466},{"level":2,"title":"Examples - Marketplace app","slug":"examples---marketplace-app","at":5759,"chars":1419},{"level":2,"title":"Related information","slug":"related-information","at":7178,"chars":149}],"text":"# Benefits and guidelines for using a prefix or suffix\nIn your extension, the name of each new application object (table, page, codeunit), must contain a prefix or suffix. This rule applies to all objects. You can use the ../developer/properties/devenv-caption-property values for what you decide to display to the user. When you modify a core Dynamics 365 object using a table extension or a page extension, the prefix/suffix must be defined at the control/field/action/group level.\n## Benefits\nThe use of affixes reduces name collisions with objects defined in other extensions.\nEnvironments that have extensions with name collisions can experience issues when deploying new extensions, when upgrading the environment, or when creating a sandbox as a copy of the current environment (for production environments).\n## General rules\n The prefix/suffix must be at exactly three characters\n The object/field name must start or end with the prefix/suffix\n If a conflict arises, the one who registered the prefix/suffix always wins\n For your own objects and extension objects, you can either use a namespace of at least two levels or you must set the prefix/suffix at the top object level\n For pages/tables/enums/reports/permissionsets in the base application or other apps that you extend, you must set the prefix/suffix at the control/field/action/procedure/values/dataitem/column level\n For extension objects that extend objects from the same publisher as your app, affixes aren't needed at the control/field/action/procedure/values/dataitem/column level\n Use the AppSourceCop<../developer/devenv-using-code-analysis-tool> tool to find all missing prefixes and/or suffixes. Configuration options for this tool can be found ../developer/analyzers/appsourcecop. The Rules section explains the different checks that the analyzer does. For prefix/suffix detection, refer to the Configuration section. It explains how to set your affixes in the AppSourceCop.json file.\n## Affixes requirements for extensions\n### For Marketplace extensions\n> IMPORTANT\n> The use of affixes for object names is required for Marketplace submissions as part of the Technical Validation Checklist<../developer/devenv-checklist-submission>.\nIn order to meet the requirements for the Marketplace technical validation, you must have a three letters affix registered for your extension publisher, and you must use the affix in your extension.\nIf you don't have any affixes registered yet, contact us at mailto:d365val@microsoft.com?subject=Affix%20Registration%20Request&body=MPN%20ID%3A%20%3CMPN%20ID%20in%20Partner%20Center%3E%0APublisher%20Name%3A%20%3Cthe%20publisher%20name%20that%20you%20use%20in%20your%20extensions%20(in%20the%20app.json%20file)%3E%0AAffixes%3A%20%3Cfive%20affix%20suggestions%20(each%20exactly%20three%20characters%20long)%20in%20order%20of%20priority%3E and provide us with the following information to reserve the prefix/suffix of your choosing:\n Your MPN ID,\n The publisher name that you use in your extensions (in the app.json file),\n You must provide at least five affix suggestions. Each affix must be exactly three characters.\n> NOTE\n> Affixes aren't case-sensitive, which means that for example \"ABC\", \"abc\", and \"AbC\" are treated as the same affix. Providing both \"ABC\" and \"abc\" counts as only one of your suggestions.\nNote, that you aren't required to change any already registered affixes; you can continue using these affixes. The guidelines only apply to new registrations.\n### For per-tenant extensions\nPer-tenant extensions aren't required to use a prefix or suffix, but we strongly recommend that you do so. You can use pte as prefix or suffix to avoid conflicts with Marketplace apps or base objects.\n> NOTE\n> If your per-tenant extension causes a conflict with a new object in the base application or an updated Marketplace app, then the per-tenant extension will be required to make the change.\n## Examples of objects with affixes or namespaces\nUse a two-level namespace for your top-level objects to avoid needing affixes. Otherwise, declare your objects with a prefix or suffix as shown in the following examples.\n### Table\n```al\nnamespace MyUniquePublisherName.Sales;\n\ntable 70000000 Salesperson\n{\n    Caption = 'Sales Person';\n}\n```\n```al\ntable 70000000 MyPrefixSalesperson\n{\n    Caption = 'Sales Person';\n}\n```\n```al\ntable 70000001 SalespersonMySuffix\n{\n    Caption = 'Sales Person';\n}\n```\n### Page\n```al\nnamespace MyUniquePublisherName.Sales;\n\npage 70000000 Salesperson\n{\n    Caption = 'Sales Person';\n}\n```\n```al\npage 70000000 MyPrefixSalesperson\n{\n    Caption = 'Sales Person';\n}\n```\n```al\npage 70000001 SalespersonMySuffix\n{\n    Caption = 'Sales Person';\n}\n```\n### Page extension objects\nFor extension objects which are extending other publishers' objects, affixes are required.\n```al\nactions\n{\n    addafter(ApprovalEntries)\n    {\n        action(MyPrefixVacation)\n        {\n            Caption = 'Vacation';\n        }\n    }\n}\n```\n```al\nactions\n{\n    addafter(ApprovalEntries)\n    {\n        action(VacationMySuffix)\n        {\n            Caption = 'Vacation';\n        }\n    }\n}\n```\n### Codeunit\n```al\nnamespace MyUniquePublisherName.Sales;\n\ncodeunit 70000000 Salesperson\n```\n```al\ncodeunit 70000000 MyPrefixSalesperson\n```\n```al\ncodeunit 70000001 SalespersonMySuffix\n```\n## Examples - per-tenant extension\nLet's say that you're creating a per-tenant extension, myext and you want to future-proof the naming by applying the prefix or suffix pte, which you aren't required to register.\nLet's look at some examples:\nPrefixes|Suffixes\npte-myext-salespersoncode|salespersoncode-myext-pte\npte_myext_salespersoncode|salespersoncode_myext_pte\npte myext salesperson code|salesperson code myext pte\npteMyExtSalesPersonCode|SalesPersonCodeMyExtPte\n## Examples - Marketplace app\nAlternatively, let's say that your company is Fabrikam, and you're building an app called Rentals. First thing, you email mailto:d365val@microsoft.com and register fab as your company affix.\nA registered affix must be three letters, no more, no less, and you must provide the publisher name, which you use in the app.json file when you apply for an affix.\nOnce you get confirmation from Microsoft, you're free to use object and field names that start with fab or end with fab. Here are some examples:\nPrefixes|Suffixes\nfab-salespersoncode|salespersoncode-fab\nfab_salespersoncode|salespersoncode_fab\nfab salespersoncode|salespersoncode fab\nFabSalesPersonCode|SalesPersonCodefab\nAt Fabrikam, another team is building another app, so you request a special affix for your app so that the two Fabrikam apps can be kept apart. In this scenario, you don't have to register anything with Microsoft, as long as you do this with your company affix. Here are some examples:\nPrefixes|Suffixes\nfab-rentals-salespersoncode|salespersoncode-rentals-fab\nfab_rentals_salespersoncode|salespersoncode_rentals_fab\nfab rentals salesperson code|salesperson code rentals fab\nFabRentalsSalesPersonCode|SalesPersonCodeRentalsfab\nIn this scenario, your AppSourceCop.json file configuration specifies `fab-rentals` and `rentals-fab` as values for mandatoryaffixes, even though only fab was registered with Microsoft.\n## Related information\nChecklist for submitting your app<../developer/devenv-checklist-submission>\nRules and guidelines for AL code<apptest-overview>"}