URL Embedding allows you to specify both a div selector within your application or webpage AND a URL where you want Candu content to display.

This is useful for:

  • When you have a repetitive div selector across multiple pages - once Candu content is embedded in this single div, it will display content on all pages (probably not what you want!)

  • When you have URL paths that contain variable information meaning URLs are unique for different users/customers

Candu will look for both a div match and URL match to ensure content is displayed in the right place.

Setting Up URL Embeds

From the Candu editor, go to the content that you want to limit to or hide from a certain URL.

Go to Settings > Embed. If you have embedded the content via the Candu Chrome Extension, the div selector will already be populated. If you have manually embedded Candu content via code, you will need to input the div selector manually (the div that is hosting your content).

On the settings tab of content you can embed URLs to ensure content is embedded in the right place in your application

You can then input the URL so that your content is embedded on the correct pages within your application or hidden from certain pages.

You can also add more than one URL and easily remove once added.

You can add multiple URLs to show content on or hide content from

What are Wildcard URLs?

Wildcard URLs provide a way for you to load your Candu content dynamically, depending on the page URL.

As an example, consider the following URL: https://candu.ai/workspaces/678/22

The 678 refers to the unique 'UserID' and 22 to the unique 'OrgID' which are both portions of the URL path that will change depending on the customer or user. The rest of the URL will remain the same.

You can simply replace the variable parts of a URL with an asterisk (*), also known as a wildcard. By adding in an *, you are telling Candu that you want the URL matching to allow that part of the URL to be variable.

When replacing the 'userid' and 'org' portions of the URL with an *, the URL will appear as follows: https://candu.ai/workspaces/**

Another example is when an application offers a different URL per customer such as:

companyname.candu.ai

You can add a wildcard for this use case: *.candu.ai


Setting up Wildcard URLs

The process is the same as adding a standard URL Embed apart from the format of the URLs entered.

⚠️ Please note you cannot test wildcard URLs in preview mode prior to content actually being embedded. We recommend embedding content in a staging environment or creating an 'Only Me' segment for testing purposes.

Did this answer your question?