Articles on: Share & analyse

Personalise texts through URL parameters

You can replace text on a published page with values from the page URL, such as a visitor's name, by adding URL parameters to the link you share. You mark the text as personalisable in the editor, then add ?replace=true and one parameter per personalisable field to the page URL. In the example below, a variable in the heading is replaced with the name from the URL.


Image: example of a personalised page


For an overview of all personalisation options, see Content personalisation.


Setting up a personalisable text


To make a text replaceable through a URL parameter:


  1. Open your page in the editor.
  2. In a heading or text, type a variable in square brackets where the personal value should go, for example [NAME]. You need a variable only to replace part of the text.
  3. Right-click the text and choose Personalise element.
  4. At "What do you want to replace?", choose Replace part of text to replace only the variable, or Completely replaced to replace the whole text.
  5. At "What do you call this field", check or enter the field name. This name becomes the URL parameter. If the text contains a variable, the name is filled in from it, so [NAME] becomes Name. If the field is empty, type a name, for example Name.
  6. At "When field is empty", choose what visitors see when the URL has no value for this field:
    • Show default value: enter the text to show at "What is the default value".
    • Delete element completely: the element is hidden.
  8. Click Save personalised items.
  9. Publish your page. URL parameters only work on the live URL after you publish the personalisable fields.


If the text contains more than one variable, each variable has its own field. Set steps 5 and 6 for each.


To change a personalisable text later, open the options menu in the top-left corner marked by an M and choose Personalise elements. It lists the elements on the page that are already personalisable.


Building a personalised URL


A personalised URL is the live URL of your publication with replace=true and one parameter per personalisable field added to it. To build one:


  1. Copy the live URL of your publication.
  2. Add ?replace=true to the end of the URL.
  3. For each personalisable field, add &, the parameter name, = and the value, for example &name=Berry.
  4. Share the URL.


Example:


https://yourpublication.maglr.com/?replace=true&name=Berry


The parameter name is the field name from "What do you call this field", written as follows:


  • Lowercase: the field Name becomes the parameter name.
  • No spaces or special characters: only the letters a to z, digits and - are kept, so the field First name becomes the parameter firstname.


Without replace=true in the URL, no values from the URL are applied. If the live URL already contains a ?, add &replace=true instead of ?replace=true.


What visitors see when a value is missing


When the URL has no parameter for a personalisable field, or no replace=true at all, the field's "When field is empty" setting decides what visitors see:


  • Show default value: the text entered at "What is the default value" is shown.
  • Delete element completely: the element is hidden.


Frequently asked questions


Why doesn't my URL parameter change the text?


Check these three things:


  • The URL contains replace=true. Without it, no values from the URL are applied.
  • The parameter name matches the field name from "What do you call this field", in lowercase and without spaces or special characters. For example, the field First name needs the parameter firstname.
  • You published the page after setting up the personalisable text. URL parameters only work on the live URL with the published fields.


How do I add a space in a value?


Write the space as %20 in the URL. For example, name=Berry%20Jansen shows "Berry Jansen".


Can I personalise more than one text with one URL?


Yes. Add one parameter per personalisable field, each starting with &, for example ?replace=true&name=Berry&company=Maglr. Fields that have the same name all get the same value.


Can I personalise an image through a URL parameter?


Yes. Right-click the image, choose Personalise element, check the name at "What do you call this field" (by default Image), click Save personalised items and publish the page. In the URL, add the field name in lowercase as the parameter and the full web address of the new image as the value, for example &image= followed by the image address.

Updated on: 28/10/2026