Xperience Docs
    • Documentation
      Installation Using the Kentico interface Developing websites Configuring Kentico Managing users Securing websites Deploying websites Managing website content Multilingual websites Macro expressions External utilities Integrating 3rd party systems Custom development E-commerce features On-line marketing features Community features Running Kentico on Microsoft Azure Using Amazon web services with Kentico Certified extensions References Release notes - Kentico 10
    • Tutorial
      Getting started with Kentico Using the Kentico interface Site development overview Creating a new website Adding styles to the website Working with the Pages application Creating the master page Creating website pages Creating page templates Next steps
    • API Examples
      Content management On-line marketing E-commerce Social and Community Development Configuration

      Is this really the version you are looking for? Kentico Xperience 10 Documentation is no longer updated. Use the switcher in the header to choose your product version.

        • Documentation
          Installation Using the Kentico interface Developing websites Configuring Kentico Managing users Securing websites Deploying websites Managing website content Multilingual websites Macro expressions External utilities Integrating 3rd party systems Custom development E-commerce features On-line marketing features Community features Running Kentico on Microsoft Azure Using Amazon web services with Kentico Certified extensions References Release notes - Kentico 10
        • Tutorial
          Getting started with Kentico Using the Kentico interface Site development overview Creating a new website Adding styles to the website Working with the Pages application Creating the master page Creating website pages Creating page templates Next steps
        • API Examples
          Content management On-line marketing E-commerce Social and Community Development Configuration
        • Installation
          • Quick installation on a local machine
          • Server and hosting requirements
            • Configuring IIS for the installation of Kentico
          • Installing Kentico - custom installation
          • Installing Kentico (Questions and Answers)
          • Deploying Kentico to a live server
            • Creating virtual directories and application pools in IIS 7.5 and 7.0
          • Additional database installation
          • Adding and removing components from an installed Kentico web project
          • Installing Kentico from the command line
            • Command line installation - XML configuration
          • Troubleshooting installation issues
            • Application stops after being idle
            • Disk permission problems
            • Database connection problems
          • Uninstalling Kentico
          • Hotfix Instructions - Kentico 10
            • Hotfix Instructions - Kentico 10 Source Code
          • Upgrading to Kentico 10
            • Upgrading Kentico manually
            • Upgrading custom code
            • Upgrading Microsoft Azure projects
            • Upgrading projects under source control
        • Using the Kentico interface
        • Developing websites
          • Website development basics
          • Choosing the right development model
          • Defining website content structure
            • Page types
              • Creating page types
              • Creating content only page types
              • Creating container page types
              • Advanced content modeling
              • Configuring page types
                • Changing page type icons
                • Creating alternative forms for page types
                • Specifying the URL pattern for content only pages
                • Extending the page type listing filter
                • Limiting the pages users can create
                • Reference - Page type properties
            • Custom tables
              • Creating custom tables
              • Editing custom tables
              • Managing custom table data
              • Creating alternative editing forms for custom tables
              • Setting custom table permissions
          • Preparing your environment for team development
            • Setting up continuous integration
              • Continuous integration repository structure
              • Object types supported by continuous integration
              • Excluding objects from continuous integration
              • Restoring continuous integration files to the database
              • Using continuous integration with Visual Studio
            • Working with object locking
            • Editing object code externally
          • Developing websites using the Portal engine
            • Creating portal engine page templates
            • Editing page layouts
            • Using and configuring web parts
            • Creating portal engine master pages
            • Inheriting portal engine page content
            • Working with layout web parts
            • Using web part containers
          • Developing websites using ASPX templates
            • Creating master pages for ASPX templates
            • Creating ASPX page templates
            • Adding portal engine functionality to ASPX page templates
            • Using both ASPX and portal templates on a single site
            • Exporting portal engine templates as ASPX
          • Developing sites using ASP.NET MVC
            • Starting with MVC development
              • Installing Kentico integration packages
            • Defining content structure on MVC sites
            • Developing MVC applications
              • Retrieving content on MVC sites
                • Working with page attachments in MVC applications
                • Working with media libraries on MVC sites
                • Checking page permissions on MVC sites
              • Initializing Kentico services with dependency injection
              • Generating classes for Kentico objects
              • Displaying shared content in MVC applications
              • Working with forms on MVC sites
              • Providing friendly URLs on MVC sites
                • Avoiding duplicate URLs on MVC sites
              • Working with users on MVC sites
                • User registration on MVC sites
                • Resetting passwords on MVC sites
                • External authentication on MVC sites
              • Providing smart search on MVC sites
              • Adding preview mode support for MVC sites
              • Localizing data on MVC sites
              • Handling 404 Not Found globally in MVC applications
              • Processing scheduled tasks when developing MVC applications
              • Testing MVC controllers
              • Improving performance of MVC applications
              • Debugging SQL queries with Glimpse on MVC sites
            • Deploying MVC applications
            • Developing on-line stores in MVC
              • Displaying product listings on MVC sites
                • Providing product filters on MVC sites
              • Displaying product details on MVC sites
                • Displaying product variants on MVC sites
              • Displaying discount values on MVC sites
              • Checkout process in MVC
                • Using a shopping cart on MVC sites
                  • Adding coupon code fields to MVC checkout processes
                • Customer details step in MVC checkout
                  • Accessing addresses of registered customers on MVC sites
                • Preview step in MVC checkout
                  • Connecting to payment gateways on MVC sites
              • Displaying and updating orders on MVC sites
            • Implementing on-line marketing features on MVC sites
              • Logging activities on MVC sites
                • Enabling tracking of activities on MVC sites
              • Tracking contacts on MVC sites
              • Tracking campaigns on MVC sites
                • Customizing the page visit hash function for campaigns in MVC
              • Content personalization on MVC sites
              • Email marketing on MVC sites
                • Handling newsletter subscriptions on MVC sites
                • Tracking marketing emails on MVC sites
                • Troubleshooting marketing emails on MVC sites
              • Contact groups, personas and scoring on MVC sites
              • Marketing automation on MVC sites
              • Separating the contact management database on MVC sites
            • Supported and unsupported Kentico features on MVC sites
            • Kentico licensing for MVC applications
          • Using ASP.NET Web API with Kentico
          • Managing page templates
          • Loading and displaying data on websites
            • Loading page data
              • Writing page path expressions
            • Building website navigation
            • Loading data using custom queries
            • Displaying data from custom tables
            • Writing transformations
              • Creating transformations for pages
              • Using hierarchical transformations
              • Writing transformations for custom tables
              • Using transformations in macro expressions
              • Displaying context menus in transformations
              • Reference - Transformation methods
            • Filtering and paging data
            • Displaying data - advanced scenarios
              • Creating wizards on websites
              • Setting up syndication feeds
                • Syndication transformations
                • Usage example - CMS RSS feed
                • Usage example - RSS feed + Data source
                • Usage example - RSS repeater + Data source
                • Usage example - External RSS feed
                • Syndication web parts and widgets
              • Displaying related pages using named relationships
              • Displaying image galleries
              • Displaying maps
                • Displaying static maps
                • Displaying dynamic maps
          • Managing responsive images
            • Defining image filters
            • Defining image variants
            • Generating image variants
            • Displaying image variants on pages
          • Designing websites using CSS
            • Combining stylesheets from multiple sources
            • Using printer friendly CSS styles
            • Creating printable versions of pages
            • Creating skins using ASP.NET themes
            • Adding CSS to page components
          • Previewing design changes
          • Developing websites for mobile devices
            • Configuring mobile development
            • Creating device profiles
            • Resizing images for devices
            • Creating page layouts for devices
            • Mapping shared mobile layouts
            • Creating mobile pages
            • Creating separate website sections for mobile devices
            • Device macros
          • Preparing widgets for users
            • Creating widgets
            • Setting up widget zones on pages
            • Configuring permissions for widgets
          • Validating website code and accessibility
            • Validating HTML code
            • Validating CSS
            • Validating links
            • Validating accesibility
          • Managing JavaScript files
          • Troubleshooting websites
            • Viewing system information
            • Working with the system event log
            • Debugging
        • Configuring Kentico
          • Managing sites
            • Installing new sites
              • Creating new sites using the wizard
              • Creating new sites from templates
              • Creating web templates
            • Setting domain names for sites
            • Managing site licenses
            • Setting up multiple websites
              • Running multiple sites on a single domain
              • Configuring nested websites
            • Setting a site favicon
            • Switching sites to off-line mode
            • Configuring settings for sites
              • Settings - Content
                • Settings - Content management
                • Settings - Media
                • Settings - Blogs
                • Settings - Translation services
              • Settings - URLs and SEO
              • Settings - Security & Membership
                • Settings - Passwords
                • Settings - Protection
                • Settings - Authentication
                  • Settings - OpenID
                  • Settings - Windows LiveID
                  • Settings - Claims-based authentication
                  • Settings - Facebook
                  • Settings - LinkedIn
              • Settings - System
                • Settings - Performance
                • Settings - Emails
                • Settings - Files
                • Settings - Health monitoring
                • Settings - Output filter
                • Settings - Search
                • Settings - Debug
              • Settings - On-line marketing
                • Settings - Contact management
                  • Settings - Activities
                  • Settings - Geolocation
                  • Settings - Inactive contacts
                • Settings - Email marketing
                • Settings - Web analytics
              • Settings - E-commerce
                • Settings - Authorize.NET
                • Settings - PayPal
              • Settings - Community
                • Settings - Avatars
                • Settings - Chat
                  • Settings - Web parts
                • Settings - Forums
                • Settings - Friends
                • Settings - Groups
                • Settings - Message boards
                • Settings - Messaging
              • Settings - Social marketing
                • Settings - URL shorteners
              • Settings - Intranet & Collaboration
                • Settings - Events
              • Settings - Versioning & Synchronization
                • Settings - Staging
                • Settings - Object versioning
                • Settings - Web farm
              • Settings - Integration
                • Settings - Integration bus
                • Settings - Microsoft SharePoint
                • Settings - REST
                • Settings - WebDAV
                • Settings - Salesforce.com
                • Settings - 51Degrees.mobi
                • Settings - Strands Recommender
          • Managing files
            • Storing files
            • Uploading files
            • Resizing images on upload
            • Adding watermarks to images
            • Administering files globally
            • Editing file metadata
          • Configuring page URLs
            • URL format and configuration
            • Setting page aliases
            • Wildcard URLs
            • Extensionless and custom URLs
            • Linking pages and files
            • Custom handling of URL path values
          • Search engine optimization
            • Configuring websites for SEO
            • Editing metadata of pages
            • Google Sitemaps
            • Managing robots.txt
          • Optimizing website performance
            • Loading data efficiently
            • Configuring caching
              • Caching page output
                • Using output cache substitutions
              • Caching files and resources
              • Caching the data of page components
              • Setting cache dependencies
              • Debugging cache
              • Caching best practices for typical projects
              • Reference - Cache settings
            • Using code minification and compression
            • Setting up web farms
              • Configuring web farm servers
              • Troubleshooting web farms
              • Debugging web farms
            • Selecting content archival approach
          • Setting up search on your website
            • Enabling search indexing
            • Creating search indexes
              • Defining page indexes
              • Defining forum indexes
              • Defining custom table indexes
              • Defining on-line form indexes
              • Defining user indexes
              • Defining general indexes
            • Monitoring search indexing tasks
            • Adding search functionality to pages
              • Setting up predictive search
            • Configuring search assistance features
            • Searching attachment files
              • Configuring SQL search for attachment files
            • Using search filters
            • Smart search syntax
            • Displaying search results using transformations
            • Searching according to page permissions
            • SQL search
          • Scheduling tasks
            • Configuring scheduled task execution
            • Installing the Scheduler Windows service
            • Reference - scheduled task properties
          • Configuring SMTP servers
            • Reference - SMTP server properties
            • Configuring sender email addresses
          • Managing email templates
          • Working with widget dashboards
            • Managing widget dashboard content
            • Adding widget dashboards to the interface
          • Using output filters
          • Configuring time zones
            • Managing time zones
          • Working with object versioning
            • Using object versioning
            • Objects recycle bin
          • Creating alternative forms
            • Code names of automatically used alternative forms
            • Displaying filters using alternative forms
          • Health monitoring
            • Registering performance counters
            • Installing the Health monitoring Windows service
            • Enabling health monitoring
            • Monitoring using the Performance monitor
            • Reference - default performance counters
          • Adding cookie law consent to web pages
            • Cookie levels
            • Reference - Kentico cookies
          • Banning IP addresses
          • Configuring countries
          • Working with system reports
            • Creating reports
            • Creating report categories
            • Defining report parameters
            • Storing data from reports
            • Displaying reports on websites
            • Subscribing to reports
            • Example - creating a simple report
            • Reporting security
          • Configuring Windows Communication Foundation
          • Configuring the code editor
        • Managing users
          • Security model overview
          • User management
            • Impersonating a different user
            • Managing my profile
          • Role management
          • Membership management
          • Configuring the application dashboard
          • Configuring permissions
            • Configuring page permissions
              • Permissions for all content
              • Permissions for page types
              • Page-level permissions (ACLs)
                • Hiding pages based on permissions
            • Configuring design permissions
          • User registration and authentication
            • Configuring forms authentication
              • Using the Registration form and Custom registration form web parts
              • New user registration approval and email confirmation
              • Customizing user registration emails
            • Configuring multi-factor authentication
            • Configuring Windows AD authentication
              • Securing a website section using Windows authentication
              • Configuring mixed-mode authentication
            • Claims-based authentication
            • Windows Live ID authentication
              • Registering your application to use Microsoft accounts
              • Configuring Windows Live ID authentication
              • Web parts available for Windows Live ID authentication
            • OpenID authentication
              • Web parts available for OpenID authentication
            • Facebook authentication
              • Loading user information from Facebook profiles
            • LinkedIn authentication
              • Creating your LinkedIn application
              • Web parts available for LinkedIn authentication
            • Managing users coming through a third-party authentication service
            • Configuring autocomplete for user names
            • Sharing user accounts between sites
            • Configuring single sign-on
            • Sign-in troubleshooting
          • Customizing the format of usernames
          • Monitoring on-line users
            • Enabling monitoring of on-line users
            • Managing on-line users
          • UI Personalization
            • Example - UI personalization
          • Allowing users to change the information they share
          • Sending emails
        • Securing websites
          • Designing secure websites
            • Securing and protecting the system
              • Flood protection
              • Banned IPs
              • Clickjacking protection
              • Session protection
              • Autocomplete deactivation
              • Preventing duplicate poll voting and content rating
              • Screen locking
              • Spam protection (CAPTCHA)
              • Event log and security debug
            • Securing user accounts and passwords
              • Setting the user password format
              • Password strength policy and its enforcement
              • Password expiration
              • Invalid sign-in attempts
              • Forgotten password
              • Unlocking user accounts
              • Custom password calculation
            • Configuring permissions securely
              • Special security permissions
            • Managing external authentication
            • Securing the Staging and REST web services
            • Configuring email confirmations
            • PCI compliance
          • Developing secure websites
            • Macros and security
            • Query string hashing
            • Handling error messages securely
              • Designing secure error messages
              • Creating custom error handling pages
            • Cross site scripting (XSS)
            • SQL injection
            • Argument injection
            • Command injection
            • Lightweight Directory Access Protocol (LDAP) injection
            • XPath injection
            • Cross site request forgery (CSRF/XSRF)
            • Unvalidated redirects
            • Directory traversal
            • Enumeration
          • Deploying websites to a secure environment
            • Configuring SSL
              • SSL accelerator support
            • Restricting access to directories
            • Disabling unnecessary modules and services and keeping the system up-to-date
            • Hiding system information
            • Minimal secure configuration
            • Web.config file settings
          • Security checklists
            • Security checklist - designing a website
            • Security checklist - developing a website
            • Security checklist - deploying a website
        • Deploying websites
          • Publishing projects from Visual Studio
          • Content staging
            • Configuring content staging
            • Bi-directional content staging
            • Synchronizing the content
            • Automatic content synchronization
            • Staging large files
            • Using X.509 authentication
            • Content staging security
            • Troubleshooting staging
          • Deployment mode for virtual objects
          • Exporting and importing sites
            • Export folder structure
            • Export/import package directory browsing
            • Excluding files and folders from export
            • Exporting sites
            • Exporting objects
            • Exporting single objects
            • Importing a site or objects
            • Importing to web application projects
        • Managing website content
          • Using the My desk dashboard
          • Working with pages
            • Creating new pages
            • Editing pages
              • Using the editor
                • Working with text
                  • Pasting text
                  • Searching and replacing in text
                  • Using the spelling checker
                  • Removing text formatting
                • Creating tables
                • Inserting media content using the editor
                • Working with links and anchors
                • Inserting widgets using the editor
                  • Inserting polls
                  • Inserting forms
                  • Inserting content rating
            • Deleting pages
            • Copying and moving pages, creating linked pages
            • Multiple page operations
            • Using workflows
            • Scheduling pages for publishing
            • Modeling content by reusing pages
            • Sending links to unpublished pages
            • Searching in pages
            • Setting page aliases in content only pages
            • Categorizing pages
              • Creating personal page categories
              • Assigning pages to categories
              • Viewing pages assigned to personal categories
            • Tagging pages
          • Working with files
            • Page attachments
              • Attaching files to pages
              • Editing page attachments
              • Deleting page attachments
              • Attaching file groups to pages
            • Content tree files
              • Inserting files into the content tree
              • Editing content tree files
              • Deleting content tree files
            • Media library files
              • Creating media libraries
              • Inserting files into media libraries
              • Editing media library files
              • Copying and moving media library files
              • Deleting media library files
            • Inserting media files on a page
            • Editing images
          • Adding page content through widgets
          • Blogs
            • Creating blogs
            • Creating blog posts
            • Moderating blog comments
            • Managing your blog post comment subscriptions
          • Events
            • Creating events
            • Managing events and event attendees
          • Forms
            • Creating new forms
            • Designing forms using the Form builder
            • Designing forms using the Field editor
            • Displaying forms on the live site
            • Defining custom form layout
            • Managing form data
            • Form notification emails
            • Form autoresponder emails
            • Creating alternative forms for on-line forms
            • Using macros with forms
            • Using form data in Scoring, Personas and Contact groups
          • Polls
            • Creating polls
            • Creating polls in multiple languages
            • Placing polls on pages
          • Exporting data from the user interface
            • Exporting data from the UI - Advanced export
          • Configuring the environment for content editors
            • Enabling on-site editing
            • Configuring blogs
              • Allowing users to create blogs on the live site
              • Allowing users to contribute to blogs on the live site
              • Blog comment notifications
                • Allowing users to subscribe to blog comment notifications
              • Allowing users to moderate blog comments on the live site
            • Configuring categories
              • Creating global and site categories
              • Viewing pages assigned to global and site categories
              • Allowing users to categorize pages on the Form tab
            • Configuring events
              • Creating an Events page
              • Displaying various page types in a Calendar web part
            • Configuring forms
              • Configuring the Form builder
              • Forms security
            • Configuring media libraries
              • Allowing group members to create group media libraries on the live site
              • Allowing users to upload media library content on the live site
              • Displaying media library content on the live site
              • Allowing users to insert links to media on the Form tab
              • URLs of resized images in media libraries
              • Media libraries security
                • Assigning permissions to media libraries
                • Securing media libraries
            • Configuring polls
            • Configuring tags
              • Creating tag groups
              • Displaying tags on a page
              • Allowing users to tag pages on the Form tab
            • Configuring the editor
              • Personalizing the editor toolbars and buttons
              • Installing CKEditor plugins
              • Defining styles for the editor
              • Adding dictionaries to the spelling checker
            • Configuring workflows
              • Creating workflows
              • Applying workflows to pages
              • Defining basic workflow steps
              • Designing advanced workflows
                • Adding advanced workflow steps
                • Connecting advanced workflow steps
                • Defining if/else conditions in advanced workflows
                • Defining user decisions in advanced workflows
                • Defining automatic decisions in advanced workflows
                • Setting timeouts for automatic approving in advanced workflows
                • Adding action steps in advanced workflows
                • Creating custom action workflow steps
              • Configuring workflow step permissions
              • Configuring workflow email notifications
            • Configuring and using page versioning
              • Configuring content versioning without workflow
              • Content locking
            • Setting up content notifications
              • Creating notification message templates
              • Defining notification gateways
              • Allowing users to subscribe to content change notifications
            • Configuring page status icons
            • Configuring UI data export
            • Configuring WebDAV
              • WebDAV requirements and limitations
              • Adjusting WebDAV settings
              • WebDAV integration with workflow and versioning
              • Editing files using WebDAV edit mode
              • Editing metafiles using WebDAV edit mode
              • WebDAV browse mode
                • WebDAV browse mode specifics and limitations
                • Mapping a WebDAV network drive
                • Example - WebDAV browse mode editing
              • Installing and running WebClient service
            • Creating grouped page attachments
        • Multilingual websites
          • Setting up multilingual websites
            • Setting default languages for users and visitors
            • Configuring URLs for multilingual websites
              • Creating language selectors
            • Support for right-to-left languages
            • Defining culture-dependent workflow scopes
            • Allowing content editors to edit only specified language versions
          • Setting up a multilingual user interface
            • Working with resource strings
            • Creating site specific resource strings
            • Localizing text fields
          • Editing the content of multilingual websites
            • Comparing language versions
            • Language status overview
          • Configuring translation services
            • Configuring content for translation
            • Machine translation - Microsoft Translator
            • Machine translation - Google Translate
            • Human translation services - Translations.com
            • Human translation services - Email translation
            • Human translation services - Manual translation
          • Translating content using external services
            • Translating localization strings using machine translation
            • Managing standard (human) translation submissions
            • Importing completed human translations
          • Developing unique page templates for specific languages
          • Changing the date and time format
        • Macro expressions
          • Macro syntax
          • Entering macro expressions
          • Writing macro conditions
            • Building conditions using macro rules
            • Creating macro rules
          • Caching the results of macros
          • Troubleshooting macros
            • Debugging macros
            • Working with macro signatures
            • Searching for macros
          • Extending the macro engine
            • Registering custom macro methods
            • Adding custom macro fields
            • Creating macro namespaces
          • Resolving macros using the API
          • Reference - Macro methods
        • External utilities
          • Kentico AD Import Utility
          • Kentico Import Toolkit
            • Importing data from external sources
            • Example - Importing users using the Kentico Import Toolkit
            • Example - Importing a culture version of a page using the Kentico Import Toolkit
          • Kentico Installation Manager
            • Registering an instance in KIM
            • Upgrading and hotfixing an instance in KIM
            • Uninstalling an instance in KIM
          • Kentico Hotfix and Upgrade Utility
            • Upgrading and hotfixing an instance
            • Restoring a backed-up LocalDB database
          • Kentico Service Manager
        • Integrating 3rd party systems
          • Integrating Kentico with other applications
            • Child web application fails to start
          • Kentico REST service
            • Configuring the REST service
            • Authenticating REST requests
            • Getting data using REST
              • Examples of data retrieved via the REST service
              • ODATA service documents
            • Manipulating data using REST
              • Managing pages using REST
              • Managing objects using REST
            • Sending REST requests from code
          • Using the integration bus
            • Integration bus overview
            • Enabling the integration bus
            • Creating integration connectors
              • Implementing outgoing synchronization
              • Implementing incoming synchronization
            • Managing integration tasks
            • Example - Integration connector
            • Reference - Integration bus data types
            • Integration bus database model
          • Using the Kentico API externally
            • Displaying Kentico content in external applications
          • Salesforce integration
            • Configuring Salesforce integration
            • Replicating contacts to Salesforce
            • Example - Replicating a contact into a Salesforce lead
            • Force.com integration API
          • Strands Recommender integration
            • Integrating the Strands Recommender service into your store
            • Placing Strands recommendations on a page
            • Placing Strands recommendations into emails
            • Troubleshooting the Strands Recommender integration
            • Customizing how products are categorized in the Strands integration
          • Integrating SharePoint
            • Configuring SharePoint integration connections
              • Connecting to SharePoint Online
            • Configuring SharePoint integration web part
            • Configuring SharePoint integration settings
            • Displaying SharePoint data in Kentico
            • Example - Displaying a SharePoint picture library in Kentico
            • Managing SharePoint libraries
              • Working with files from SharePoint libraries
          • Visualizing Kentico data in Power BI
        • Custom development
          • Best practices for customization
          • Developing web parts
            • Creating new web parts
            • Working with web part properties
            • Customizing web parts
            • Creating inherited web parts
            • Using custom web part layouts
            • Advanced web part development scenarios
              • Developing layout web parts
              • Developing data source web parts
              • Developing custom filters
              • Connecting web parts with the page wizard
          • Developing form controls
            • Managing form controls
            • Assigning form controls to fields
            • Inheriting from existing form controls
            • Defining form control parameters
            • Example - Developing custom form controls
            • Creating form controls with XML values
            • Reference - Field editor
          • Creating custom modules
            • Initializing modules to run custom code
            • Creating extenders for module interface pages
            • Manually creating the interface for custom modules
            • Creating custom binding classes
            • Setting the type information for module classes
              • Adding references between classes
              • Setting parent-child relationships for classes
              • Enabling export and staging for the data of classes
              • Enabling continuous integration for custom classes
              • Reference - ObjectTypeInfo
            • Adding custom website settings
            • Reference - Managing UI elements
            • Creating installation packages for modules
              • Example - Creating a packageable module
              • Installing modules from installation packages
              • Uninstalling modules
            • Troubleshooting custom modules
            • Licensing custom modules
          • Handling global events
            • Handling object events
            • Customizing event logging
            • Handling custom external authentication
            • Handling custom claims-based authentication
            • Handling custom multi-factor authentication
            • Making custom modifications to output HTML
            • Excluding content from staging and integration
            • Customizing staging of child and binding objects
            • Automatically synchronizing staging and integration tasks
            • Deploying objects with custom ID fields
            • Reference - Global system events
          • Editing system tables
          • Loading custom classes from App_Code
          • Database table API
          • Retrieving database data using ObjectQuery API
          • Working with pages in the API
            • Page database structure
            • Storing custom data for all page types
          • Custom table internals and API
          • User internals and API
            • Checking permissions using the API
          • Customizing the system's data classes (Info objects)
          • Customizing providers
            • Registering providers using assembly attributes
            • Registering providers via the web.config
            • Custom Info provider example
            • Custom Email provider example
            • Custom Data provider example
            • Creating custom SQL search providers
          • Caching in custom code
          • Working with physical files using the API
            • Using CMS.IO
            • Writing a custom file system provider
            • Configuring file system providers
              • Configuring Amazon S3
              • Configuring Azure storage
          • Writing automated tests
            • Creating automated test projects
            • Faking Info and Provider objects in unit tests
            • Creating integration tests with a connection string
            • Creating isolated integration tests
          • Managing database views and stored procedures
          • Miscellaneous custom development tasks
            • Adding custom code to portal engine page templates
            • Adding custom methods to transformations
              • Example - Displaying categories in page lists
            • Scheduling custom tasks
            • Smart search API and customization
              • Creating custom smart search indexes
              • Creating custom smart search analyzers
              • Adding custom search text extractors for files
              • Customizing the content of search indexes
            • Web part API
            • Widget internals and API
            • Web farm internals and API
              • Creating custom web farm synchronization tasks
            • Registering CSS preprocessors
            • Working with form data using the API
            • Developing custom translation services
              • Creating machine translation services
              • Creating human translation services
              • Loading translation service classes from App_Code
              • Reference - Translation service properties
              • Translating content via REST
              • Customizing XLIFF export for translations
            • Working with database queries in the API
            • Synchronizing content using the API
            • Media libraries API
            • Notifications API
              • Developing custom notification gateways
                • Creating custom notification gateway forms
                • Creating custom notification gateway classes
                • Registering custom notification gateways
            • Adding custom performance counters
            • Cloning objects through the API
            • Creating custom RSS feed pages manually
            • Displaying correct time in your code
            • Working with font icons
            • Displaying data on application tiles
            • Serializing objects to XML using the API
            • Customizing CSS for the administration interface
        • E-commerce features
          • Getting familiar with the E-commerce Solution
          • Configuring your store
            • Installing the e-commerce sample sites
            • Tips for configuring the store
            • Choosing site or global e-commerce configuration
              • Enabling global e-commerce objects and settings
              • Configuring e-commerce settings for a specific site or globally
              • Using global e-commerce objects and settings
            • Configuring currencies
              • Configuring exchange rates
            • Configuring taxes
              • Assigning taxes to products automatically
            • Configuring multilingual stores
            • Configuring product page types
            • Configuring products
              • Configuring product structure
              • Importing products
                • Importing products using Kentico Import Toolkit
                  • Example - Importing new products using Kentico Import Toolkit
                • Importing products using API
            • Configuring product pages
              • Configuring product listings with filtering
              • Reference - Product web parts
            • Checkout process
              • Configuring steps of the checkout process
              • Allowing checkout processes for anonymous or registered customers
              • Enabling automatic registration for anonymous customers
              • Displaying the shopping cart preview on pages
              • Removing old shopping carts from the database
              • Reference - Checkout process web parts
                • Configuring the Shopping cart totals web part
            • Configuring shipping options
              • Configuring shipping carriers
            • Configuring payment methods
              • Configuring customer credit
              • Configuring Authorize.NET
              • Configuring PayPal
              • Reference - Payment methods
            • Configuring invoices
            • Configuring e-commerce email notifications
            • Configuring user registration in stores
            • Configuring e-commerce permissions
          • Managing your store
            • Products
              • Adding new products
              • Managing stand-alone SKUs
              • Managing product representations
                • Managing Standard products
                • Managing E-commerce memberships
                • Managing E-products
                • Managing Donations
                • Managing Bundles
              • Working with product options
                • Creating and modifying product options
                  • Reference - Product option category properties
                  • Reference - Product option properties
                  • Example - Adding a product with a Text option
                  • Example - Adding a product with Attribute options
                  • Example - Adding a product with Products options
                • Removing product options
              • Working with product variants
                • Example - Adding a product with variants
              • Product statuses
              • Categorizing products
                • Departments
              • Managing manufacturers
              • Managing suppliers
              • Linking existing products or sections
            • Customers
              • Creating customers manually
              • Modifying customer details
              • Registering customers manually
              • Assigning roles to customers
              • Assigning memberships to customers manually
              • Managing customers' credit
            • Orders
              • Order statuses
            • Discounts
              • Working with catalog discounts
                • Example - Applying a catalog discount
              • Working with order discounts
                • Example - Applying an order discount
              • Working with free shipping offers
                • Example - Redeeming a free shipping offer
              • Working with volume discounts
                • Example - Applying volume discounts on a selected product
              • Working with Buy X Get Y discounts
                • Example - Applying a Buy X Get Y discount
                • Example - Applying a Buy X Get Y discount
              • Working with discount coupons
                • Working with product coupons
                  • Example - Applying a coupon code to receive a discount on selected products
                • Coupons for order discounts, free shipping, and Buy X Get Y discounts
                  • Use coupon codes for free shipping
                  • Use coupon codes to receive a discount
            • Store reports
              • Using the Store reports dashboard
              • Store overview
            • Maintaining multilingual stores
          • Customizing and developing your store
            • E-commerce customization model
            • Customer-related customizing
              • Customizing creation of new customers
              • Synchronizing customer and user properties
              • Customizing customers' preferred currency, payment method and shipping option
            • Product-related customizing
              • Customizing product prices
              • Customizing product option forms
              • Mapping product type database columns
            • Shopping cart-related customizing
              • Retrieving the current shopping cart
              • Customizing marking shopping carts as abandoned
            • Discount-related customizing
              • Configuring discount rules
                • Example - Adding a catalog rule
                • Example - Adding an order rule
              • Customizing evaluation of Buy X Get Y discounts
              • Customizing application of Buy X Get Y discounts
            • Payment-related customizing
              • Creating a custom payment gateway
              • Customizing tax classes
              • Making payment methods dependent on shipping options
              • Working with payment results
            • Shipping-related customizing
              • Implementing custom shipping carrier providers
                • Example - Creating a shipping carrier provider with costs based on the country
              • Example - Custom shipping option selection
            • Customizing orders
        • On-line marketing features
          • Configuring and customizing your on-line marketing features
            • Best practices for EMS performance
            • Configuring on-line marketing permissions
            • Configuring contacts
              • Configuring contact recognition
              • Mapping fields to contact attributes
              • Using geolocation for contacts
              • Adding custom fields to contacts
              • Enabling on-line contact monitoring
              • Setting up automatic deletion of contacts
            • Configuring activities
              • Enabling activity tracking
              • Adding custom activity types
              • Logging custom activities through the API
            • Configuring content personalization
              • Personalizing web parts and web part zones
              • Creating a personalized page - example
            • Configuring email marketing
              • Preparing email templates
              • Integrating email feeds into sites
              • Enabling double opt-in for newsletters
              • Enabling marketing email tracking
              • Configuring bounced email monitoring
              • Troubleshooting marketing emails
            • Configuring marketing automation
              • Developing custom marketing automation actions
              • Handling marketing automation triggers
              • Walkthrough - Sending an automated reminder of an abandoned shopping cart
            • Configuring optimization testing
            • Configuring web analytics
              • Enabling web analytics
              • Managing search engines for web analytics
              • Configuring logging of actions as custom conversions
              • Web analytics API
                • Adding custom web analytics
                • Logging custom conversions through the API
              • Setting up automatic web analytics data cleanup
              • Debugging web analytics
            • Adding banners to a page as web parts
            • Changing the campaign report update interval
            • Recommending pages to personas through web parts
            • On-line marketing macros
              • Improving custom macro performance in scoring and contact groups
            • Separating the contact management database
              • Rejoining the contact management database
          • Managing your on-line marketing features
            • Banners
              • Creating banners
              • Placing banners on a page as widgets
              • Monitoring banner statistics
              • Using banners - example
            • Campaigns
              • Setting up campaigns
                • Setting up campaigns on MVC sites
              • Scheduling and evaluating campaigns
            • Contact management
              • Working with contacts
                • Importing contacts
                • Assigning statuses to contacts
                • Organizing contacts into accounts
                • Viewing on-line contacts
                • Merging contacts
              • Segmenting contacts into contact groups
              • Tracking contact activities
                • Viewing contact activities
                • Logging activities - example
                • Manually logging custom activities
                • Reference - Activity types
              • Scoring contacts
                • Managing contact scores
                • Using contact scoring - example
            • Personas
              • Defining personas
              • Recommending pages to personas through widgets
              • Viewing contacts assigned to personas
            • Content personalization
              • Personalizing editor widgets
              • Setting display conditions for personalization variants
            • Email marketing
              • Creating email campaigns
              • Creating newsletters
              • Writing marketing emails
              • Sending marketing emails
              • Managing marketing email recipients
              • Tracking marketing emails
              • Monitoring bounced marketing emails
              • A/B testing marketing emails
              • Placing Strands recommendations into marketing emails
            • Marketing automation
              • Working with marketing automation processes
              • Working with the automation process designer
                • Managing automation process steps
                • Connecting automation process steps
                • Defining automatic decisions in processes
                • Defining user choice steps in automation processes
                • Setting timeouts for automation process steps
                • Adding wait steps to automation processes
                • Configuring step security for automation processes
                • Adding marketing actions to automation processes
              • Setting triggers for automation processes
              • Manually running automation processes
              • Managing the flow of contacts in automation processes
              • Viewing marketing automation reports
              • Using automation process versioning
              • Walkthrough - Creating a marketing automation process
                • Marketing automation walkthrough - Preparing the prerequisites
                • Marketing automation walkthrough - Creating the process
                • Marketing automation walkthrough - Designing the process
                • Marketing automation walkthrough - Managing the process
            • Optimization testing
              • A/B testing website pages
                • Creating A/B tests for pages
                • Analyzing A/B test results
                • Using A/B testing - example
              • Multivariate testing
                • Creating MVT tests
                • Analyzing MVT test results
                • Using MVT testing - example
            • Web analytics
              • Viewing web analytics reports
              • Monitoring traffic from search engines
              • Logging custom conversions on your website
              • Using Google analytics
        • Community features
          • Abuse reports
            • Abuse reporting web parts
            • Adding abuse reporting functionality to transformations
            • Managing abuse reports
            • Integrating abuse reporting with other community features
          • Avatars
            • Changing user avatars
            • Changing group avatars
            • Managing avatars
            • Using Gravatars
            • Displaying avatars in transformations
          • Bad words
            • Enabling bad words filtering
            • Defining bad words
            • Handling bad words
          • Badges
            • Defining badges
            • Assigning badges to users
            • Displaying badges in user profiles
          • Chat
            • Prerequisites for using Chat
            • Chat - quick start
            • Chat - technical overview
            • Managing chat rooms
            • Managing chat users
            • Setting up chat on site
              • Chat web parts
              • Setting up chat in single page mode
              • Setting up chat in redirection mode
              • Grouping chat web parts
            • Customizing chat appearance
              • Customizing chat CSS
              • Writing transformations for chat
              • Chat transformations reference
            • Using chat on the live site
              • Logging in to chat
              • Sending chat messages
            • Using support chat
              • Working with canned responses
            • Cleaning up unused chat data
          • Content rating
            • Using the Content rating web part
            • Displaying content rating in transformations
            • Using content rating in message boards
          • Forums
            • Creating forum groups
            • Creating predefined forums
            • Publishing a predefined forum on the website
            • Adding an ad-hoc forum to a page
            • Configuring forum search
            • Enabling forum favorites
            • Enabling friendly URLs for forum posts
            • Attaching files to forum posts
            • Using BBCode in forum posts
            • Managing forum posts
            • Managing forum subscriptions
            • Moderating forums
            • Managing forum security
            • Customizing forum design
            • Reference - forum group properties
            • Reference - forum properties
          • Friends
            • Requesting friendships
            • Friends management email templates
            • Managing friends
            • Friends web parts
            • Friends - examples of use
            • Friends security
          • Groups
            • Working with groups
            • Allowing users to create groups
            • Customizing group pages using widgets
            • Creating groups on the live site
            • Email templates for groups
            • Groups security
          • Message boards
            • Placing message boards on pages
            • Managing message boards
            • Setting Board base URL
            • Message boards security
            • Message boards notifications
          • Messaging
            • Sending a message
            • Adding the messaging functionality to the live site
            • Configuring email notifications for messages
          • User contributions
            • Example - Publishing community news
            • Example - Editing partner profiles
            • User contributions security
          • Integrating social media
            • Connecting Kentico to social media
            • Adding social media accounts
            • Posting to social media
            • Viewing Facebook insights
            • Viewing Twitter analytics
            • Viewing LinkedIn statistics
            • Configuring automatic posting to social media
            • Setting up URL shorteners
        • Running Kentico on Microsoft Azure
          • Microsoft Azure web hosting options
          • Running Kentico in Azure Web Apps
            • Setting up Kentico in Azure Web Apps
            • Deploying existing Kentico projects to Azure Web Apps
            • Migration of Kentico projects from Azure Cloud Services to Azure Web Apps
            • Adjusting the web hosting plan mode on Azure Web Apps
            • Increasing storage capacity on Azure Web Apps
            • Enabling web farms on Azure Web Apps
            • Azure Web Apps problematic folders
          • Running Kentico in Azure Cloud Services
            • Architecture of Microsoft Azure Cloud Services
            • Requirements and limitations for running Kentico in Azure Cloud Services
            • Lifecycle for developing Kentico projects in Azure Cloud Services
            • Preparing the Azure cloud environment
            • Installing Kentico Azure projects
            • Configuring Kentico Azure projects for Cloud Services
            • Deploying Azure projects to Cloud Services
            • Installing the database for Azure projects
            • Developing Kentico Azure projects locally
            • Scaling Azure Cloud Services
            • Converting an existing project to an Azure project
            • Troubleshooting Azure projects
          • Developing for Microsoft Azure - best practices
          • Configuring Azure CDN
          • Mapping the Web analytics storage folder to the server file system
          • Preventing Azure cache folders from bloating
          • Recommendations on using Azure SQL Database tiers
          • Storing cache and session state data in Azure environment
          • Troubleshooting Smart search on Azure
        • Using Amazon web services with Kentico
        • Certified extensions
        • References
          • Kentico Controls
            • Adding Kentico controls to the Visual Studio toolbox
            • Generic controls
              • UniView
              • Paging controls
                • UniPager
                  • Implementing the IUniPageable interface
                • DataPager
                • TemplateDataPager
            • Basic controls
              • BasicTabControl
              • BasicCalendar
              • BasicDataGrid
              • BasicDataList
              • BasicRepeater
              • BasicUniView
            • CMS controls
              • CMS controls - Navigation
                • CMSBreadCrumbs
                • CMSListMenu
                • CMSSiteMap
                • CMSTabControl
                • CMSTreeView
              • CMS controls - Listings and viewers
                • CMSDocumentValue
                • CMSCalendar
                • CMSDataGrid
                • CMSDataList
                • CMSRepeater
                • CMSUniView
                • CMSViewer
                • Using nested controls
              • CMS controls - Listings and viewers with custom queries
                • QueryDataGrid
                • QueryDataList
                • QueryRepeater
                • QueryUniView
              • CMS controls - Edit mode buttons
                • CMSEditModeButtonAdd
                • CMSEditModeButtonEditDelete
              • CMS controls - Editable regions for ASPX templates
                • CMSEditableRegion
                • CMSEditableImage
              • SQL search controls
                • CMSSearchDialog
                • CMSSearchResults
            • UI controls
              • UniGrid
                • Reference - UniGrid definition
                • Creating custom UniGrid filters
                • Adding custom UniGrid transformations
              • UniSelector
          • Reference - Web.config application keys
          • Reference - Web parts
        • Release notes - Kentico 10
          • Kentico improvement program
        • Home
        • Macro expressions
        • Troubleshooting macros

        Troubleshooting macros

        • Copy page link | Get HelpService ID
        ✖
        Copy to clipboard

        If you encounter problems when working with macro expressions, the system provides tools that can help identify and fix the issues:

        • Debugging macros
        • Working with macro signatures
        • Searching for macros
        Go back to top
        • Community Questions & Answers
        • Contact support

        Cookie consent

        We use necessary cookies to run our website and improve your experience while browsing. Additional cookies are only used with your consent. You may revoke your consent on the Cookies Policy page or in your browser at any time.
        Configure