URL inputs

A URL input lets your team members add relative, absolute and fully qualified URLs to your data files or the front matter of markup files.

For each input, you can configure how CloudCannon handles empty values. You can also use the general configuration options available for all inputs.

URL#

The URL input provides an editing interface for relative, absolute and fully qualified URLs. CloudCannon shows a preview of the URL when the URL begins with a protocol (http:// or https://).

You can configure a URL input using the type key with the value url. Define the type key under your input key name within _inputs. For more information, please read our documentation on configuring your inputs.

_inputs:
  associate_link:
    type: url

{
  "_inputs": {
    "associate_link": {
      "type": "url"
    }
  }
}

Once configured, the URL input will appear in the Data Editor or sidebar of the Visual or Content Editor when you add it to a data file or the front matter of a markup file.

---
associate_link: http://example.com
---

Content goes here.

Options#

You can configure URL inputs using the options key under your input key, inside of _inputs.

_inputs:
  background:
    type: url
    options:
      empty_type: 

{
  "_inputs": {
    "background": {
      "type": "url",
      "options": {
        "empty_type": null
      }
    }
  }
}

URL inputs have the following options available:

Unconfigured URL inputs#

In some cases, CloudCannon can still detect a URL input even if you have not configured it.

CloudCannon will interpret any unconfigured input with the key name url or link, or that ends in _url or _link, as a URL input.

external_link: https://cloudcannon.com/

This behavior is convenient if you have simple inputs or do not want to configure inputs. It is also beneficial for new websites on CloudCannon where you have yet to create any CloudCannon-specific configuration.

Valid values#

Here are some examples of valid values for the key url.