Loading…

Websites and domains

A Website is pages written as Liquid templates and the files they use, published to the web when you choose. A Domains resource holds domain names and their DNS.

Add either from Add in a project. A new website starts with a layout, a header snippet, a home page and a /404 page, ready to publish.

At a glance

Address
Each site at its own name under tensorsites.net
Custom domains
Up to 5 per site, on Pro and Enterprise
Templates
Up to 500 per site
Registering domains
Any plan, charged to your organization’s card
Hosting DNS for a domain
Pro and Enterprise

Websites

Templates

A website's page lists its templates by kind, then its assets. Choose one to edit it in a pane beside the list; the + beside a kind makes a new one.

KindNamed byWhat it is
PageIts route, such as /aboutWhat the site answers at that address.
LayoutA name, such as defaultThe frame pages that name it are drawn in ({% layout %}), its {% block %}s filled by them.
SnippetA name, such as headerA piece any template draws in with {% render %}.
DataA name, such as postsJSON every template reads as site.data.posts.

Names are lowercase letters, digits, - and _, and may sit in folders (partials/nav). What you type and haven't saved stays with the template in this tab, marked in the list, and the tab asks before closing with anything unsaved.

Page /
{% layout 'default', title: 'Home' %}
{% block content %}
  <h1>Welcome to {{ site.name }}</h1>
  <p>Edit this page, add pages, layouts and snippets, …</p>
{% endblock %}

Websites

Pages and routes

  • / and /about answer those addresses alone.
  • /blog/:slug answers /blog/hello and any other one segment there, read as route.params.slug.
  • /files/*path, last in a route, takes everything after it: /files/a/b.txt gives route.params.path a/b.txt.
  • /404 answers whatever nothing else does.

Of several routes that match, the closest wins: a name over a :param over a *rest, from the first segment on. A route ending in an extension answers as that type: /feed.xml as XML, /robots.txt as text, anything else as HTML. A site without its own /sitemap.xml or /robots.txt is given them, listing its pages.

Websites

Assets

Assets are the images, fonts, scripts and other files the site uses. Drop files anywhere on the website's page, or open Assets and upload them, in folders if you like. Each is served at its own path (/images/logo.png) and, through the asset_url filter, at an address of its contents that browsers keep for good.

A request with no page of its route is answered with the asset at that path, else that path's .html, else a folder's index.html, so a site of uploaded files works as it is.

Websites

Preview and publish

  1. Preview, in the toolbar's menu, opens what would be published now in a new tab, at a private address only people who can open the website may visit.
  2. Publish puts it online. Every template is parsed and every page with a fixed route rendered first: if any fails, nothing is published, and the template opens at the line that failed.

Edits never reach the live site until you publish again. Settings' Unpublish takes the site offline.

Websites

Releases

Every publish is a release. The website's Settings › Releases lists them, newest first, with the one that's Live; Put back brings an earlier one online as it was, if a change went wrong. What you're editing now waits for the next publish.

Websites

Custom domains

On Pro and Enterprise a site can be served at up to five domains of your own, besides its own address.

  1. In the website's Settings › Domains, enter the domain and choose Add domain.
  2. At your DNS host, add a CNAME record for it pointing at the site's own address. A domain that can't have one, such as example.com itself, uses its DNS host's ALIAS or ANAME instead, with the TXT record shown.
  3. Choose Verify. Once its DNS points here, the site is served there with a certificate of its own.

A domain in one of your Domains resources needs none of this: connect it from there.

Domains

A domains resource

A Domains resource holds domains registered here and domains registered elsewhere whose DNS is hosted here, each with its DNS records, contacts and certificates. Organize them in folders. Purchases are charged at once to your organization's billing card, which any plan may have; a resource's Settings › Purchases lists what was bought.

Domains

Register a domain

  1. Choose Register a domain and search for a name, such as acme or acme.com.
  2. Add the ones you want to your Cart, with how many years each.
  3. Give the registrant's contact details, then Review order and confirm. If a price changed meanwhile, nothing is charged.

A domain registered here renews by itself, and comes with a transfer lock, WHOIS privacy, our DNS and a free certificate for it and its www.

Domains

Bring a domain

Choose Add an existing domain for one registered elsewhere, and either:

  • Host its DNS only (Pro and Enterprise): it stays registered where it is. Prove it's yours with the TXT record shown, then point it at our nameservers.
  • Transfer it here with its transfer code: its registration moves here, adding a year, charged now.

Domains

DNS records

Open a domain to see its records. Add, edit and delete them, filter them by type, name or value, and import or export a zone file. Set up mail adds the records a common mail provider needs. Records the app keeps for you, such as a website's, are marked; editing one of a website's records disconnects that address from the site.

Its Nameservers are ours unless you choose others, and every change to the domain is in its History.

Domains

Connect a website

From a domain, point it, or a subdomain such as www or shop, at any website you can open, or make a new website there. Its records are added and kept for you, and the site is served there once its certificate is issued.

Domains

Certificates

Domains registered here get a free Let's Encrypt certificate that renews itself. On a paid plan you can also order a paid certificate, or upload one of your own with its private key, and choose which one the domain uses.

Domains

Renewals and transfers

Each domain shows when it expires. Turn auto-renew off or on, or Renew now for more years. To move a domain to another registrar, turn off its transfer lock and get its transfer code under Transfer away.

Questions or something missing? Contact us.