---
title: Internationalized Resource Identifiers (IRIs)
slug: cms-11/dev-docs/internationalized-resource-identifiers-iris
docTags: 
createdAt: 2026-07-22T19:45:22.322Z
---

When creating URL segments (typically from the content name) or simple address, by default, Optimizely only allows characters according to [RFC 1738](http://www.faqs.org/rfcs/rfc1738.html), which basically allows alphabetic characters, digits, dash (-), underscore (\_), tilde (\~), period (.) and dollar ($).

You can define a custom character set to be used. To do this, update the `UrlSegmentOptions` configuration in the IOC container. When a character set is defined that allows characters outside RFC 1738, the setting `UrlSegementOptions.SupportIriCharacters` should be set to `true` so that URLs get properly encoded. Below is an example of a character set that allows Unicode characters in the letter category.

```csharp
using EPiServer.ServiceLocation;
using EPiServer.Framework.Initialization;
using EPiServer.Framework;
using EPiServer.Web;

namespace EPiServerSite {
  [ModuleDependency(typeof (EPiServer.Web.InitializationModule))]
  public class IRIConfigurationModule: IConfigurableModule {
    public void ConfigureContainer(ServiceConfigurationContext context) {
      context.Services.RemoveAll<UrlSegmentOptions>();
      context.Services.AddSingleton<UrlSegmentOptions>(s => new UrlSegmentOptions {
        SupportIriCharacters = true,
          ValidCharacters = @ "\p{L}0-9\-_~\.\$"
      });
    }

    public void Initialize(InitializationEngine context) {}

    public void Uninitialize(InitializationEngine context) {}
  }
}
```

`UrlSegmentOptions` also exposes a `CharacterMap` property, where you can to define a mapping for unsupported characters, for example, `'ö' => 'o'`.

## Internationalized Domain Names (IDN)

As explained in [IDN and IRI](https://www.w3.org/International/articles/idn-and-iri/), internationalized domain names are registered in Punycode format (a way of representing Unicode characters using only ASCII characters).

Internationalized domain names should be registered in their punycode format in the CMS admin view under **Manage Websites**.