Integration

Character encoding

Surreal publishes content encoded as UTF-8. UTF-8 is capable of representing every character in the Unicode character set, including those from many different alphabets. If you publish a page and notice strange characters appearing, chances are your pages are not being served as UTF-8.

Setting UTF-8 with meta tags

To tell browsers to use UTF-8 on your pages, place the following into the head section of your pages:

<meta charset="utf-8">

For your convenience, Surreal will automatically try to update your character encoding during publishing if it detects that it hasn’t been set to UTF-8.

Troubleshooting

In some cases, your server may be configured to serve pages as ISO-8859-1 or another encoding even if you have the correct meta tag. If you’re still seeing encoding issues, try one of the following solutions.

In your .htaccess file

If your server supports .htaccess files, you can add the following line to set the encoding:

AddDefaultCharset UTF-8

This line should go inside your .htaccess file. If you don’t see this file in your home directory, you can simply create it using a text editor.

ASP.NET users

Try adding this to your web.config file:

<globalization
    requestEncoding="utf-8"
    responseEncoding="utf-8"
    fileEncoding="utf-8"
/>

ColdFusion users

Try adding this to the top of the affected pages:

<cfprocessingdirective pageencoding="utf-8">

Integration

Character encoding

Setting UTF-8 with meta tags

Troubleshooting

In your .htaccess file

ASP.NET users

ColdFusion users

Integration

Users

Sites

Pages

White-labeling

Resources