CMS Manager: Edit Texts, Content, and Emails Yourself

The action menu also includes “Copy” (creates a disabled copy with the suffix “(Copy)”), “Delete” (only for your own pages), and “Open CMS Page in the Store” (for pages with their own URL).

Pre-installed pages have a locked status toggle; you can unlock footer modules and custom pages starting with ID 1000; “Delete” is only available for custom pages. Click to enlarge.

Design

The editor bar offers text color, alignment, tables, images, and links. In the link dialog, use “Class” to turn a link into a button, such as “Button Primary.” Enter links to other domains using the full address, i.e., https://; the store leaves this unchanged. Insert your own HTML via “Source Code.” The editor may remove elements it doesn’t recognize when you save.

You can build pages from modules with columns, tiles, and images using the xoContentEditor: If you have a license, the “Content (xoContentEditor)” button appears above the content. It’s best to create posts with dates and topics—such as a blog—as news items.

The store uses these pages to generate the PDF attachments for the order confirmation; see Attachments. In the sample cancellation form, {STORE_NAME_ADDRESS} automatically populates your address based on the default settings.

You can link a provider’s legal texts under Settings → Interfaces → Legal Portals; see Getting Started. Pages that are updated via the Händlerbund interface cannot be saved in the CMS Manager. Regarding the EU withdrawal button and personalized goods: Withdrawal Button.

General Modules

In edit mode, each red button takes you directly to the module in the CMS Manager; the X in the “Edit Mode” notice closes the view. Click to enlarge.

Texts Related to Payment Methods

Most payment methods have three modules following the same pattern. They are not listed in the CMS Manager: They are located in the payment method screen under Settings → Checkout → Payment Methods (“Edit”) below the fields, with one tab per language; alternatively, via the “CMS” action in the list—see Payment Methods.

A block name containing “$” may only be active once; otherwise, the store will no longer display any text for that name. The CMS Manager will therefore refuse to save or activate it if another active page has the same name. from 4.9.50

This guide does not cover the homepage, sliders, banners, or boxes.

For each template, the list shows the technical name (e.g., $mail_order_confirmation) and the internal name (e.g., “Order Confirmation”). The search field finds templates by ID or name. The action menu includes “Edit,” “Preview,” and “Send Test Email.”

The search finds templates by ID and name; in addition to “Edit,” the action menu includes “Preview” and “Send Test Email.” Click to enlarge.

Emails regarding newsletters, product notifications, and tickets are explained in the guides “Newsletters,” “Product Notifications,” and “Tickets & Tasks.”

Editing a Template

Header, Footer, Logo, and Colors

Each email consists of the header (template $mail_header with logo and store name), the actual template, and the footer ($mail_footer with address and links to the store, legal notice, and right of withdrawal). The header and footer apply to all emails.

• Address, Phone, Fax: The footer inserts the information from Settings → General → Basic Settings → Store Address and Contact Information via {STORE_NAME_ADDRESS}. Enter the business hours there in the “Free Field” and include the shortcode <adds> in the “Standard Output Format.” The same information appears in the store’s footer under “Contact.”
• Logo: By default, the “Shop Logo” from the Basic Settings is used. To select a different logo specifically for emails, go to the Email Options under “Alternative Email Logo” and set the width using “Email Logo – Maximum Width.”
• Colors: Color blocks are generated using placeholders such as {DESIGN_SUCCESS}, which draw from your shop’s design colors. To use a different color in a specific template, replace the placeholder there with a color value such as #1a1a1a. The shop colors themselves are located in an area visible only to XONIC Support; please contact us.
• Signature: The greeting and contact information for shop emails are included in the respective template and in the footer. You can create a personal signature for ticket replies and for Tools → Send Email under Settings → Administrators → My Account → Signature (Ticket System).

You can create your own templates in the “Create New Email” tab. The shop sends them via marketing events using the “Send Email” action; see Marketing & Automation. XONIC Premium: Marketing / Automatisierungen & Künstliche Intelligenz

The order confirmation consists of:

• the text from the “Order Confirmation”template in the Mail Manager, including addresses, items, and totals via placeholders;
• the footer text for the selected payment method: Where it says {cms:cms_payment_email_footer}, the store inserts the block …_email_footer for that payment method; for prepayment, it inserts $cms_vorkasse_email_footer.

The bank details for the prepayment email are therefore contained in the module. By default, it includes sample text (“Payable to … Company … Account Holder …”). The “Shop Bank Account …” fields in the basic settings appear there only if you insert the placeholders. They are also used for invoices (payment QR code, e-invoice) and cash-on-delivery payments via DHL.

Step by Step

The bank details below the totals come from the $cms_vorkasse_email_footer module for the prepayment payment method. Click to enlarge.

A text block sets the comment, status, and toggle; “ {orders:ship_track_nr} ” retrieves the tracking number from the “Shipping” tab. Click to enlarge.

Shipping Number in the Email

1. First, enter the tracking number: in the order under the “Shipping” tab, in the “Carrier Tracking Number(s)” field; see Shipping & Delivery. With a shipping label integration, the store enters it automatically.
2. In the comment or text block, use {orders:ship_track_nr} for the number and {orders:ship_track_link} for the tracking link, for example, “Your tracking number: {orders:ship_track_nr}.”
3. Select the shipping status (default “✅ Shipped”), enable “Notify Customer” and “Add Comments,” then submit by clicking “Update.” The store replaces the placeholders as soon as you save; if the number is missing at that time, the field remains blank.

Excerpt from the email options showing the sender, test address, and recipients of the copies; omitted lines are marked with dots. Click to enlarge.

If the sample address mail@ihre_adresse_xxl.de is still listed under “Send order copy via email to,” your copies will go nowhere: Replace it with your own address. The store will notify you of every new customer account via Settings → Checkout → Customer Details → Notification upon customer registration (enabled by default).

SPF: Is your store authorized to send emails on behalf of your domain?

Receiving mail servers check the SPF record of the sender’s domain to verify whether the sending server is authorized to do so. The sender’s domain is the domain of the “shop operator’s email address.”

• “Email Mode” = phpmail (default): The server on which your store runs sends the email. It must be listed in your domain’s SPF record.
• “Email Mode” = smtp: Your email provider sends the emails. In this case, their SPF record applies, and you should use an address from that mailbox as the shop operator’s address.
• Free email address as the operator address: Its SPF will not allow your shop server. Under “Shop Operator’s Email Address (SPF),” enter an address from your own domain.

You set the SPF record in your domain’s DNS through the provider that manages the domain. If your store is hosted by XONIC, their support team will help you with the correct entry. As a rule, a correct SPF record is sufficient. DKIM is an optional addition: The shop will only sign in SMTP mode if “Email DKIM Signature: Domain,” “Email DKIM Signature: Selector,” and “Email DKIM Signature: PrivateKey” are filled in (if the key is encrypted, also include “Email DKIM Signature: Passphrase”). You then enter the public key as a TXT record at <Selektor>._domainkey.<Ihre Domain>.

Welcome email bounces back as undeliverable

Correct the email address in the customer’s account. If the email still does not arrive, use the “Generate Password Link” option in the drop-down menu on the customer’s profile page to create a link that allows the customer to set their password, and forward it to them via another method. The store does not send anything in this case. “Send welcome message including password,” on the other hand, sets a new password and sends it via email.

Frequently Searched Texts in xoLanguage

Order and status emails are sent in the language of the order. You can also change the name of a payment method, such as “Prepayment,” in xoLanguage; see Payment Methods.