Xperience Docs
  • MVC
  • Portal Engine
  • Documentation
  • Tutorial
  • API Examples

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

    • MVC
    • Portal Engine
    • Documentation
    • Tutorial
    • API Examples
    • Kentico development models
      • Supported features on MVC sites
    • Installation
      • Quick installation
      • System requirements
        • Configuring IIS for the installation of Kentico
      • Installing Kentico
      • Installing Kentico MVC projects
      • Installation Questions and Answers
      • Additional database installation
      • Adding and removing components of Kentico installations
      • Installing Kentico from the command line
        • Command line installation - XML configuration
      • Manually configuring Kentico applications in IIS
      • Troubleshooting installation issues
      • Uninstalling Kentico
      • Hotfix Instructions - Kentico 12
        • Hotfix Instructions - Kentico 12 Source Code
      • Upgrading to Kentico 12
        • Upgrading Kentico manually
        • Upgrading custom code
        • Upgrading Microsoft Azure projects
        • Upgrading projects under source control
    • Using the Kentico interface
      • Configuring the application dashboard
      • Managing my profile
    • Developing websites
      • Portal Engine development overview
      • MVC development overview
      • Starting with MVC development
        • Installing Kentico integration packages
        • Adding an administration redirect to MVC sites
      • Preparing your environment for team development
        • Working with object locking
        • Editing object code externally
      • 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
        • Synchronizing database changes not managed by continuous integration
      • Defining website content structure
        • Choosing the format of page content
        • Creating and configuring page types
          • Creating standard page types
          • Creating content-only page types
          • Creating container page types
          • Configuring page types
            • Reusing existing page content
            • 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
        • Managing custom tables
          • Creating custom tables
          • Managing custom table data
          • Creating alternative editing forms for custom tables
          • Setting custom table permissions
          • Custom table internals and API
      • Initializing Kentico services with dependency injection
      • Form builder development
        • Developing form components
          • Defining form component properties
          • Filtering form components
          • Using a dynamic data source with selector components
          • Example - Developing a custom form component
        • Developing custom form layouts
        • Defining field validation rules
        • Defining field visibility conditions
        • Customizing the Form widget
        • Assigning editing components to properties
        • Reference - System form components
      • Page builder development
        • Creating pages with editable areas in MVC
        • Developing widgets in MVC
          • Defining widget properties in MVC
          • Creating inline editors for widget properties
          • Example - Developing a widget in MVC
        • Developing page builder sections
          • Defining section properties
        • Developing page templates in MVC
          • Defining page template properties in MVC
          • Filtering page templates in MVC
        • Developing modal dialogs for builder component properties
        • Page and media selectors for page builder components
      • Distributing custom builder components
      • Generating classes for Kentico objects
      • Retrieving content in MVC applications
        • Displaying page content
        • Displaying shared content
        • Displaying page attachments
        • Displaying content from media libraries
        • Adding preview mode support
      • Developing websites using 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
        • Adding custom code to Portal Engine page templates
      • Developing websites using ASPX templates
        • Creating master pages for ASPX templates
        • Creating ASPX page templates
        • Adding Portal Engine functionality to ASPX page templates
        • Combining ASPX and Portal Engine templates on a single site
        • Exporting Portal Engine templates as ASPX
      • 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
          • Adding custom methods to transformations
            • Example - Displaying categories in page lists
          • Reference - Transformation methods
        • Filtering and paging data
        • 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
          • Creating custom RSS feed pages manually
        • Displaying related pages
        • Displaying image galleries
        • Displaying maps
          • Displaying static maps
          • Displaying dynamic maps
      • Configuring page URLs on MVC sites
        • Avoiding duplicate URLs on MVC sites
        • Enabling alternative URLs for pages
      • Testing MVC controllers
      • 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
        • Registering CSS preprocessors
      • Previewing design changes
      • Managing page templates
      • Developing web parts
        • Creating new web parts
        • Working with web part properties
        • Customizing web parts
        • Creating inherited web parts
        • Using custom web part layouts
        • Developing layout web parts
        • Developing data source web parts
        • Developing custom filters
        • Connecting web parts with the page wizard
        • Web part internals and API
      • Preparing widgets for users
        • Creating widgets
        • Setting up widget zones on pages
        • Configuring permissions for widgets
        • Widget internals and API
      • Validating website code and accessibility
        • Validating HTML code
        • Validating CSS
        • Validating links
        • Validating accessibility
      • Developing websites for mobile devices
        • 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
        • Configuring 51Degrees device detection
      • Managing JavaScript files
      • Rewriting application URLs
      • Troubleshooting websites
        • Viewing system information
        • Working with the system event log
        • Debugging
        • Debugging SQL queries with Glimpse on MVC sites
      • 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
      • Reference - Web parts
    • 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
          • Kentico licensing for MVC applications
        • 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 - Groups
            • Settings - Message boards
          • 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 - Strands Recommender
      • Managing files
        • Storing files
        • Uploading files
        • Resizing images on upload
        • Adding watermarks to images
        • Administering files globally
        • Editing file metadata
      • 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 via fields
        • Configuring events
          • Creating an Events page
          • Displaying various page types in a Calendar web part
        • Configuring forms
          • Configuring permissions for forms
          • Configuring the Form builder
        • Configuring grouped page attachments
        • Configuring media libraries
          • Configuring supported file types in 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 media links in page fields
          • URLs of resized images in media libraries
          • 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 via fields
        • Configuring the editor
          • Personalizing the editor toolbars and buttons
          • Installing editor 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
          • Developing custom notification gateways
            • Creating custom notification gateway forms
            • Creating custom notification gateway classes
            • Registering custom notification gateways
          • Notification internals and API
        • 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
      • Setting up search on your website
        • Enabling search indexing
        • Using Azure Search
          • Creating Azure Search indexes
          • Integrating Azure Search into pages
          • Integrating Azure Search into MVC projects
          • Customizing Azure Search
            • Adding scoring profiles to Azure Search indexes
            • Implementing suggestions for Azure Search
            • Setting analyzers for Azure Search
            • Registering custom data types for Azure Search
        • Using locally stored search indexes
          • Creating local search indexes
            • Defining local page indexes
            • Defining forum indexes
            • Defining custom table indexes
            • Defining on-line form indexes
            • Defining user indexes
            • Defining local general indexes
            • Creating custom smart search indexes
            • Creating custom smart search analyzers
          • Building a search interface for local indexes
          • Building a search interface for local indexes in MVC
          • Setting up predictive search using local indexes
          • Configuring search assistance features for local indexes
          • Adding filters for local search indexes
          • Smart search syntax
          • Displaying local index search results using transformations
          • Searching according to page permissions
          • SQL search
            • Configuring SQL search for attachment files
        • Monitoring search indexing tasks
        • Searching attachment files
          • Adding custom search text extractors for files
        • Customizing the content of search indexes
        • Smart search database tables and API
      • Setting up web farms
        • Configuring web farm servers
        • Troubleshooting web farms
        • Debugging web farms
        • Creating custom web farm synchronization tasks
        • Web farm internals and API
      • Configuring caching
        • Caching on MVC sites
        • Caching the output of personalized content
        • Caching on Portal Engine sites
          • Caching page output
            • Using output cache substitutions
          • Caching the data of page components
          • Debugging cache
          • Caching best practices for typical projects
          • Reference - Cache settings
        • Caching files and resources
        • Setting cache dependencies
        • Caching in custom code
      • Optimizing performance of MVC sites
      • Optimizing performance of Portal Engine sites
        • Loading data efficiently
        • Using code minification and compression
        • Selecting a content archival approach
      • Data protection
        • GDPR compliance
          • Personal data in Kentico
          • Creating consents
          • Working with consents
          • Working with consents on MVC sites
          • Revoking consent agreements
          • Logging web analytics based on consent
          • Implementing personal data collection
          • Implementing personal data erasure
        • Working with cookies
        • Adding cookie law consent to web pages
        • Registering custom cookies
        • Reference - Kentico cookies
      • Search engine optimization
        • Configuring websites for SEO
        • Google Sitemaps
        • Managing robots.txt
      • Configuring page URLs
        • URL format and configuration
        • Setting page aliases
        • Wildcard URLs
        • Extensionless and custom URLs
        • Linking pages and files
      • Scheduling tasks
        • Processing scheduled tasks in MVC
        • Configuring scheduled task execution
        • Installing the Scheduler Windows service
        • Reference - scheduled task properties
        • Scheduling custom tasks
      • Configuring SMTP servers
        • Reference - SMTP server properties
        • Configuring sender email addresses
        • OAuth for email servers
      • Managing email templates
      • Working with widget dashboards
        • Managing widget dashboard content
        • Adding widget dashboards to the interface
      • Configuring time zones
        • Managing time zones
        • Displaying correct time in your code
      • Configuring countries
      • 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
      • 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
      • Banning IP addresses
      • Using output filters
      • Configuring Windows Communication Foundation
      • Configuring the code editor
      • Health monitoring
        • Registering performance counters
        • Installing the Health monitoring Windows service
        • Enabling health monitoring
        • Monitoring using the Performance monitor
        • Reference - default performance counters
        • Adding custom performance counters
      • Reference - Web.config application keys
    • Managing users
      • Permission model overview
      • User registration and authentication
        • Integrating Kentico membership
        • Setting up authentication
        • Enabling user registration
        • 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
        • Configuring third-party authentication services
          • 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 user accounts created via third-party authentication services
        • External authentication on MVC sites
        • Configuring single sign-on
        • Configuring autocomplete for user names
        • Sign-in troubleshooting
      • User management
        • Impersonating a different user
      • Role management
        • Managing roles from MVC applications
      • Membership management
      • Adding custom fields to users
      • Authorizing live site actions via roles
      • Configuring permissions
        • Configuring page permissions
          • Permissions for all content
          • Permissions for page types
          • Page-level permissions (ACLs)
            • Checking page permissions
            • Restricting pages based on permissions
        • Configuring design permissions
      • Monitoring on-line users
        • Enabling monitoring of on-line users
        • Managing on-line users
      • UI Personalization
        • Example - UI personalization
      • Sharing user accounts between sites
      • Allowing user profile customization
      • Sending emails
      • User internals and API
        • Checking permissions using the API
    • Securing websites
      • Designing secure websites
        • Securing and protecting the system
          • Autocomplete deactivation
          • Screen locking
          • Event log and security debug
          • Flood protection
          • Spam protection (CAPTCHA)
          • Banned IPs
          • Clickjacking protection
          • Session protection
          • Preventing duplicate poll voting and content rating
        • Securing user accounts and passwords
          • Setting the user password format
          • Enabling password resets
          • Implementing password reset functionality for MVC sites
          • Password strength policy and its enforcement
          • Password expiration
          • Invalid sign-in attempts
          • Unlocking user accounts
          • Custom password calculation
        • Configuring permissions securely
          • Special security permissions
        • 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
          • Handling 404 errors in MVC applications
          • 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 services and keeping the system up-to-date
        • Hiding system information
        • Minimal secure configuration
        • Web.config security settings
      • Security checklists
        • Security checklist - designing a website
        • Security checklist - developing a website
        • Security checklist - deploying a website
    • Deploying websites
      • Deploying MVC sites
      • Deploying Kentico sites to a live server
      • Publishing projects from Visual Studio
      • Deployment mode for virtual objects
      • Running Kentico behind a proxy server
      • Content staging
        • Configuring content staging
        • Bi-directional content staging
        • Synchronizing the content
        • Automatic content synchronization
          • Synchronizing content using the API
        • Staging large files
        • Using X.509 authentication
        • Content staging security
        • Troubleshooting staging
      • 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
      • 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 Portal Engine projects to Azure Web Apps
          • Deploying existing MVC 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 for Cloud Services
          • 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 session state data in an Azure environment
        • Troubleshooting local search indexes on Azure
      • Using Amazon web services with Kentico
    • Managing website content
      • Using the My desk dashboard
      • Working with pages
        • Creating new pages
        • Creating new pages in MVC
        • Editing pages
        • Editing pages in MVC
        • Deleting pages
        • Editing metadata of pages
        • Copying and moving pages, creating linked pages
        • Working with page relationships
        • Multiple page operations
        • Working with pages on the live site
        • Using workflows
        • Scheduling pages for publishing
        • Reusing other pages when editing content
        • Sending links to unpublished pages
        • Searching in pages
        • Setting page aliases for content-only pages
        • Adding alternative URLs for pages
        • Categorizing pages
          • Creating personal page categories
          • Assigning pages to categories
          • Viewing pages assigned to personal categories
        • Tagging 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
      • 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
        • Editing images
        • Inserting media files on a page
      • Adding page content through widgets
      • Using widgets in MVC
      • Using page templates in MVC
      • 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 forms
        • Creating new forms
        • Composing forms
        • Using smart fields in forms
        • Designing forms using the Form builder
        • Designing forms using the Field editor
        • Localizing form fields
        • Displaying forms
        • 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
      • 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
    • Multilingual websites
      • Setting up multilingual MVC projects
      • Setting up multilingual websites
        • Localizing content on MVC sites
        • 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 page editing only for specified language versions
      • Setting up a multilingual user interface
        • Working with resource strings
        • Localizing MVC builder components
        • Creating site specific resource strings
        • Localizing text fields
      • Editing the content of multilingual websites
        • Comparing language versions
        • Language status overview
      • Using unique page templates for each language
      • 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 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
      • 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
      • 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 ASP.NET Web API with Kentico
      • 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
      • Integrating Kentico with other applications
        • Child web application fails to start
      • 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
      • 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
        • Configuring Strands recommendations email widget
        • Troubleshooting the Strands Recommender integration
        • Customizing how products are categorized in the Strands integration
      • Integrating SharePoint
        • Configuring SharePoint integration connections
        • 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
      • Collecting donations
      • Certified extensions
    • Custom development
      • Best practices for customization
      • Customizing MVC projects
      • 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
        • Working with HTML5 form inputs
        • 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
        • Custom handling of URL path values
        • Reference - Global system events
      • Editing system tables
      • Database table API
      • 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
      • Customizing the system's data classes (Info objects)
      • Retrieving database data using ObjectQuery API
      • Working with pages in the API
        • Page database structure
        • Storing custom data for all page types
        • Reference - DocumentQuery methods
      • Working with form data using the API
      • Working with database queries in the API
      • 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
      • Cloning objects through the API
      • Serializing objects to XML using the API
      • Loading custom classes from App_Code
      • 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
      • Working with font icons
      • Displaying data on application tiles
      • Customizing CSS for the administration interface
      • UI controls
        • UniGrid
          • Reference - UniGrid definition
          • Creating custom UniGrid filters
          • Adding custom UniGrid transformations
        • UniSelector
    • E-commerce features
      • Getting familiar with the E-commerce Solution
      • Developing on-line stores
        • Displaying product listings
          • Providing product filters
        • Displaying product details
          • Displaying product variants
        • Displaying discount values
        • Implementing a checkout process
          • Using a shopping cart on MVC sites
            • Adding coupon code inputs to pages in MVC
          • Gathering customer details during checkout
            • Auto-filling addresses of existing customers
          • Building the order review step
            • Connecting to payment gateways
        • Displaying and updating orders
      • Configuring on-line stores
        • 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
          • Displaying shopping cart details on pages
          • Allowing checkout processes for anonymous or registered customers
          • Displaying the shopping cart preview on pages
          • Reference - Checkout process web parts
            • Configuring the Shopping cart totals web part
        • Enabling automatic registration for anonymous customers
        • Deleting expired shopping carts from the database
        • 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 on-line stores
        • Products
          • Adding new products
          • Managing stand-alone SKUs
          • Managing product representations
            • Managing Standard products
            • Managing E-commerce memberships
            • Managing E-products
            • 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 brands and manufacturers
          • Managing product collections
          • 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 customer credit
        • Orders
          • Order statuses
        • Discounts
          • Working with catalog discounts
            • Displaying catalog discounts on the live site
            • Example - Applying a catalog discount
          • Working with volume discounts
            • Example - Applying volume discounts on a selected product
          • Working with product coupons
            • Example - Applying a coupon code to receive a discount on selected products
          • Working with Buy X Get Y discounts
          • Working with order discounts
          • Working with free shipping offers
            • Example - Redeeming a free shipping offer
          • Working with gift cards
          • Working with coupon codes
            • Adding coupon code inputs to pages
            • Example - Applying a coupon code to receive a discount on your order
            • Example - Applying a coupon code to receive free shipping
        • Store reports
          • Using the Store reports dashboard
          • Store overview
        • Maintaining multilingual stores
      • Customizing on-line stores
        • E-commerce customization model
        • Customer-related customizing
          • Customizing creation of new customers
          • Synchronizing customer and user properties
          • Customizing customer preferences
        • Product-related customizing
          • Customizing product prices
          • Customizing product option forms
          • Mapping product type database columns
        • Shopping cart-related customizing
          • Customizing the shopping cart calculation
          • Retrieving the current shopping cart
          • Customizing marking shopping carts as abandoned
        • Configuring discount rules
          • Adding a discount rule with a custom method
        • Customizing discounts
        • Payment-related customizing
          • Creating a custom payment gateway
          • 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
        • Customizing tax calculation
        • Customizing price rounding
        • Customizing orders
        • Integrating Google Analytics Enhanced Ecommerce
        • Integrating Google Analytics Enhanced Ecommerce on MVC sites
        • Customizing e-commerce data for Google Analytics
    • On-line marketing features
      • Configuring and customizing your on-line marketing features
        • Best practices for EMS performance
        • Best practices for EMS performance in MVC
        • Configuring on-line marketing permissions
        • Configuring contacts
          • Tracking contacts on MVC sites
          • 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
          • Enabling activity tracking on MVC sites
            • Logging activities on MVC sites
          • Adding custom activity types
          • Logging custom activities through the API
        • Tracking campaigns on MVC sites
          • Customizing the page visit hash function for campaigns in MVC
        • Configuring content personalization
          • Personalizing web parts and web part zones
          • Creating a personalized page - example
        • Content personalization on MVC sites
          • Developing personalization condition types
          • Example - Developing a personalization condition type
        • Configuring email marketing
          • Preparing email templates
          • Preparing email widgets
          • Handling newsletter subscriptions on MVC sites
          • Integrating email feeds into sites
          • Enabling double opt-in for newsletters
          • Enabling marketing email tracking
            • Tracking marketing emails on MVC sites
          • Configuring bounced email monitoring
          • Troubleshooting marketing emails
            • Troubleshooting marketing emails on MVC sites
          • Reference - Email marketing macro expressions
        • Configuring marketing automation
          • Developing custom marketing automation actions
          • Handling marketing automation triggers
          • Walkthrough - Sending an automated reminder of an abandoned shopping cart
        • Enabling A/B testing
          • Logging custom A/B testing conversions
        • 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
            • Example - Using contact scoring
        • 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
        • Personalizing widgets in MVC
        • Email marketing
          • Creating email campaigns
          • Creating newsletters
          • Composing marketing emails
          • Sending marketing emails
          • Managing marketing email recipients
          • Tracking marketing emails
          • Monitoring bounced marketing emails
          • Viewing the email feed statistics
          • Viewing the email report insights
          • 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
        • A/B testing pages
        • 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
      • 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
      • User contributions
        • Example - Publishing community news
        • Example - Editing partner profiles
        • User contributions security
    • Release notes - Kentico 12
      • Kentico improvement program
    • Home
    • Macro expressions
    • Troubleshooting macros

    Troubleshooting macros

    • Copy page link | Get HelpService ID
    Development model: MVC Portal Engine
    ✖
    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
    We use small cookies to improve your browsing experience and to analyze traffic. To process the analytical cookies, we need your consent. You may revoke your consent on the Cookies Policy page or in your browser at any time.