- \n
- Why 2GP automatically adds a namespace<\/li>\n\n\n\n
- How Salesforce rewrites code internally<\/li>\n\n\n\n
- Why you don\u2019t see namespaced code after installation<\/li>\n\n\n\n
- Why the code works without namespace prefixes<\/li>\n\n\n\n
- Why the namespace never appears in your Git repository<\/li>\n<\/ul>\n\n\n\n
Why 2GP Automatically Adds the Namespace<\/mark><\/strong><\/h2>\n\n\n\n
When you create a 2GP managed package, Salesforce automatically applies the package namespace to all metadata included in the package, such as:<\/p>\n\n\n\n
- \n
- Apex classes<\/li>\n\n\n\n
- Lightning Web Components (LWC)<\/li>\n\n\n\n
- Custom objects<\/li>\n\n\n\n
- Custom fields<\/li>\n\n\n\n
- Permission sets<\/li>\n\n\n\n
- Any additional packaged metadata<\/li>\n<\/ul>\n\n\n\n
With 2GP, the namespace is mandatory and is applied at build time. You never add the namespace manually in your code – Salesforce handles it automatically.<\/p>\n\n\n\n
![\"Namespace](\"https:\/\/www.greytrix.com\/blogs\/salesforce\/wp-content\/uploads\/2025\/12\/blogImg1.png\")
<\/a><\/center>Namespace Handling in Package<\/i><\/center><\/font>\n\n\n\n How Salesforce Rewrites Code Internally<\/mark><\/strong><\/h2>\n\n\n\n
Even though your source code does not contain a namespace, Salesforce injects it during the packaging process.<\/p>\n\n\n\n
For example, if your Apex code looks like this:<\/p>\n\n\n\n
insert new Invoice__c(Amount__c = 100);<\/strong><\/p>\n\n\n\n
During packaging, Salesforce internally transforms it into:<\/p>\n\n\n\n
insert new abc__Invoice__c(abc__Amount__c = 100);<\/strong><\/p>\n\n\n\n
Here, abc<\/strong> represents the package namespace.<\/p>\n\n\n\n
You should never make this change yourself. This transformation happens only within the compiled package – not in your source repository.<\/p>\n\n\n\n
Why You Don\u2019t See the Namespaced Code After Installation<\/mark><\/strong><\/h2>\n\n\n\n
Second-Generation Packaging is source-driven, which means:<\/p>\n\n\n\n
- \n
- Subscriber orgs receive compiled components, not your original source<\/li>\n\n\n\n
- The namespaced version of the code is not visible<\/li>\n\n\n\n
- Installed metadata is fully namespaced, even though you didn\u2019t write it that way<\/li>\n<\/ul>\n\n\n\n
This often leads developers to wonder how everything still works when no namespace was added manually.<\/p>\n\n\n\n
Why the Code Still Works Without Namespace Prefixes<\/mark><\/strong><\/h2>\n\n\n\n
Salesforce automatically updates all internal references during packaging, including:<\/p>\n\n\n\n
- \n
- Object references<\/li>\n\n\n\n
- Field references<\/li>\n\n\n\n
- Apex class references<\/li>\n\n\n\n
- LWC references<\/li>\n<\/ul>\n\n\n\n
As long as the references are within the same package, Salesforce ensures they are correctly namespaced.<\/p>\n\n\n\n
That\u2019s why your code behaves exactly as expected without any manual changes. Behind the scenes, Salesforce adjusts everything automatically, even though the installed version appears fully namespaced.<\/p>\n\n\n\n
Why the Namespace Doesn\u2019t Appear in Your Git Repository<\/mark><\/strong><\/h2>\n\n\n\n
You might expect your Git repository to contain namespaced code\u2014but it never will. Your repo always remains namespace-agnostic.<\/p>\n\n\n\n
This is because namespaces are applied only at packaging time. Keeping the source clean ensures that it:<\/p>\n\n\n\n
- \n
- Works in scratch orgs<\/li>\n\n\n\n
- Works without a namespace<\/li>\n\n\n\n
- Works with future packages<\/li>\n\n\n\n
- Avoids hard-coded prefixes<\/li>\n<\/ul>\n\n\n\n
This design is intentional and follows Salesforce best practices.<\/p>\n\n\n\n
Conclusion\u00a0<\/mark><\/strong><\/h2>\n\n\n\n
Salesforce Second-Generation Packaging may seem confusing at first, especially when you see namespaced metadata in subscriber orgs while your source code contains no namespace references. However, this behavior is predictable, consistent, and fully automated.<\/p>\n\n\n\n
With 2GP, Salesforce always applies the package namespace at build time. Developers should never manually add namespace prefixes in their source code. Salesforce injects namespaces internally, ensuring that installed packages are properly namespaced, protected, and isolated – while keeping your repository clean, reusable, and future-proof.<\/p>\n\n\n\n
By following the above blog instructions, you will be able to learn \u201cUnderstanding Namespace Behavior in Salesforce Second Generation Packaging (2GP)\u201c<\/strong>. If you still have queries or any related p roblems,don\u2019t hesitate to contact us at salesforce@greytrix.com<\/a>. More details about our integration product are available on our website and Salesforce AppExchange<\/a>.<\/p>\n\n\n\n
We hope you may find this blog resourceful and helpful. However, if you still have concerns and need more help, please contact us at salesforce@greytrix.com<\/a>.<\/p>\n\n\n\n
About Us<\/b><\/br>\n
Greytrix<\/a> \u2013 a globally recognized and one of the oldest Sage Development Partner and a Salesforce Product development partner offers a wide variety of integration products and services to the end users as well as to the Partners and Sage PSG across the globe. We offer Consultation, Configuration, Training and support services in out-of-the-box functionality as well as customizations to incorporate custom business rules and functionalities that require apex code incorporation into the Salesforce platform.
Greytrix has some unique solutions for Cloud CRM such as Salesforce Sage integration<\/a> for Sage X3<\/a>, Sage 100<\/a> and Sage 300 (Sage Accpac)<\/a>. We also offer best-in-class Cloud CRM Salesforce customization and development services<\/a> along with services such as Salesforce Data Migration<\/a>, Integrated App development<\/a>, Custom App development and Technical Support business partners and end users. Salesforce Cloud CRM integration offered by Greytrix works with Lightning web components and supports standard opportunity workflow. Greytrix GUMU™ integration for Sage ERP \u2013 Salesforce is a 5-star rated app listed on Salesforce AppExchange<\/a>.
The GUMU™ Cloud framework by Greytrix forms the backbone of cloud integrations that are managed in real-time for processing and execution of application programs at the click of a button.
For more information on our Salesforce products and services, contact us at salesforce@greytrix.com<\/a>. We will be glad to assist you.<\/p>\n","protected":false},"excerpt":{"rendered":"If you\u2019re transitioning to Salesforce Second-Generation Packaging (2GP), one of the first things you\u2019ll notice is that your metadata looks different after packaging. Objects, fields, Apex classes, and components suddenly appear with a namespace prefix, even though your original source code contains no such prefix. This can be confusing at first but this behavior is\u2026 Read More »<\/a><\/span><\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[3],"tags":[2702,2697,2701,2481,2699,2703,2698,2608,2705,2700,2696,2704],"class_list":["post-12106","post","type-post","status-publish","format-standard","hentry","category-salesforce-srv","tag-lwc-namespace-salesforce","tag-managed-packages-salesforce","tag-namespace-behavior-salesforce","tag-salesforce-2gp","tag-salesforce-apex-namespace","tag-salesforce-isv-development","tag-salesforce-metadata-packaging","tag-salesforce-namespace","tag-salesforce-packaging-architecture","tag-salesforce-packaging-best-practices","tag-salesforce-second-generation-packaging","tag-salesforce-source-driven-development"],"_links":{"self":[{"href":"https:\/\/www.greytrix.com\/blogs\/salesforce\/wp-json\/wp\/v2\/posts\/12106","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.greytrix.com\/blogs\/salesforce\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.greytrix.com\/blogs\/salesforce\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.greytrix.com\/blogs\/salesforce\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/www.greytrix.com\/blogs\/salesforce\/wp-json\/wp\/v2\/comments?post=12106"}],"version-history":[{"count":11,"href":"https:\/\/www.greytrix.com\/blogs\/salesforce\/wp-json\/wp\/v2\/posts\/12106\/revisions"}],"predecessor-version":[{"id":12118,"href":"https:\/\/www.greytrix.com\/blogs\/salesforce\/wp-json\/wp\/v2\/posts\/12106\/revisions\/12118"}],"wp:attachment":[{"href":"https:\/\/www.greytrix.com\/blogs\/salesforce\/wp-json\/wp\/v2\/media?parent=12106"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.greytrix.com\/blogs\/salesforce\/wp-json\/wp\/v2\/categories?post=12106"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.greytrix.com\/blogs\/salesforce\/wp-json\/wp\/v2\/tags?post=12106"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}