Skip to content
Skills Library
Programming · Building & coding

abp-localization

/abp-localization

ABP Framework v10.x (10.4–10.6) localization: localization resource, JSON files, culture fallback, L[] helper, IStringLocalizer. Use for multi-language, localization, or translation in ABP.

Repository
abp-skills ↗
Licence
MIT
Last repository change
14.08.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
1
Deprecation

No signals detected. Repository changed on 14.08.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

ABP Framework v10.x (10.4–10.6) localization: localization resource, JSON files, culture fallback, L[] helper, IStringLocalizer. Use for multi-language, localization, or translation in ABP.

Original author description

ABP Framework v10.x (10.4–10.6) localization: localization resource, JSON files, culture fallback, L[] helper, IStringLocalizer. Use for multi-language, localization, or translation in ABP.

How it works

  1. Trigger
  2. Quick Reference
  3. Related
Original SKILL.md headings · 76 lines, 188 words
SKILL.md preview
---
name: abp-localization
description: "ABP Framework v10.x (10.4–10.6) localization: localization resource, JSON files, culture fallback, L[] helper, IStringLocalizer. Use for multi-language, localization, or translation in ABP."
---

# ABP Localization Skill

## Trigger
Localization, i18n, localization resources, JSON files, culture, L[] helper, multi-language, text translation.

---

## Quick Reference

### Create Resource
```csharp
public class BookStoreResource { }
```

### Register Resource
```csharp
Configure<AbpVirtualFileSystemOptions>(options =>
{
    options.FileSets.AddEmbedded<MyModule>("YourRootNamespace");
});
Configure<AbpLocalizationOptions>(options =>
{
    options.Resources.Add<BookStoreResource>("en")
        .AddVirtualJson("/Localization/Resources/BookStore");
});
```

### JSON File
```json
{
  "culture": "en",
  "texts": {
    "HelloWorld": "Hello World!",
    "Menu:Home": "Home",
    "Hello": { "World": "Hello World!" }
  }
}
```
- `culture` field required (ABP ignores without it)
- Nested keys: `L["Hello__World"]` (double underscore)

### Usage
```csharp
// In ApplicationService
LocalizationResource = typeof(BookStoreResource);
var text = L["HelloWorld"];

// Via DI
private readonly IStringLocalizer<BookStoreResource> _localizer;
var text = _localizer["HelloWorld"];
```

### Multiple Files per Culture
```
Localization/MyResource/
├── en.json
├── en_Authors.json
├── en_Books.json
└── en_Users.json
```
Auto-merged. Split large modules by feature.

### Best Practices
- One resource per module
- Key prefixes: `Menu:`, `Permission:`, `Error:`
- Split large files by feature
- Always define `culture` in JSON
- Embed via Virtual File System
- Set `LocalizationResource` in base classes
- Localize all user-facing text

## Related

[Exception Handling](../abp-exception-handling/SKILL.md) · [UI](../abp-ui/SKILL.md) · [Settings & Features](../abp-settings-features/SKILL.md) · Docs: https://abp.io/docs/latest/framework/fundamentals/localization

Versions

RepositoryScoreLicence
This page · burakdmir/abp-skills100MIT
burakdmir/abp-skills100MIT

Database snapshot: 13.11.2026 · package version ca490c1e8353 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100localize-applications
    Framework-level ABP localization (resources, validation, exceptions, app services, text templating — not just UI). USE FOR: a LocalizationResource + [LocalizationResourceName], registering via AbpLocalizationOptions.Resources.Add(...).AddVirtualJson, sharing keys with…
  • 100menus-and-localization
    Contribute navigation menu items, and add/translate the localization json text a module's menus and UI display. USE FOR: adding or editing menu items (IMenuContributor, context.Menu.AddItem, StandardMenus.Main), adding keys to Localization/**/en.json and translating them into…
  • 100monica-ui-localization
    This skill should be used when creating, modifying, validating, or reviewing Monica UI localization/i18n resources, replacing hardcoded user-facing text, adding IStringLocalizer usage, registering localized pages or navigation categories, synchronizing zh-CN/en-US JSON files, or…
  • 100resources-localization
    Guidance for .NET resource files (.resx) and IStringLocalizer-based localization. USE FOR: .resx resource file management, IStringLocalizer and IStringLocalizerFactory usage, strongly-typed resource access, satellite assembly localization. DO NOT USE FOR: culture-aware…
  • 98abp-cli
    ABP Framework v10.x (10.4–10.6) CLI and tooling: abp new, add-package, generate-proxy, ABP Studio, ABP Suite, --modern flag. Use when working with ABP CLI commands, creating projects, adding packages, or generating proxies.
  • 100orchardcore-localization
    Localizes OrchardCore apps — UI strings (IStringLocalizer/IViewLocalizer S, T, H), LocalizationSource, updating and exporting checked-in POT templates, localization analyzers, PO files and pluralization, content translation (LocalizationPart, culture picker), and…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.