In this section · 3 articles

Set up your blog

Tell Blog where your website lives and how article addresses start, then add the authors, categories and tags your writers will choose from.

Applies to
Blog 2.3 and later
Who can do this
Platform owner, Administrator
Permission
feature.blog.setting.edit
Where
Settings hub › Blog › Blog URLs, then Blog › Authors, Categories and Tags
On this page

Before anyone writes, set your website's address and add the authors and categories articles need. An article can't be saved without a category and an author.

Before you start

  • For the addresses, you need Edit Setting (feature.blog.setting.edit) in the Blog Content group. With only View Setting, the panel opens read-only.
  • For the rest, you need Create Author, Create Category and Create Tag (feature.blog.author.create, feature.blog.category.create, feature.blog.tag.create) in the Blog Taxonomy group.
  • Have your public website's address ready, for example https://www.example.com.

1. Set where articles live

  1. Open the Settings hub, for example from Configurations › General Settings › System Settings.

  2. In the panel list, under Blog, select Blog URLs.

    The Blog URLs panel with Public site URL set to https://www.example.com, Default URL prefix set to blog, News set to news, and empty prefix fields for Article, Knowledge Base, Release Note and Documentation.
  3. In Public site URL, enter your website's address, for example https://www.example.com. This is usually not the address of your Laramin.

  4. In Default URL prefix, enter the part of the address before an article's slug, for example blog. Left empty, it's blog.

  5. To give a content type its own prefix, fill in its field: Article, News, Knowledge Base, Release Note or Documentation. For example, news for News. Types left empty use the default prefix.

  6. Select Save changes.

You see Settings saved. Prefixes may use lowercase letters, numbers, - and /.

Careful: Changing a prefix later moves every published article of that type to a new address, and Blog adds no redirects for it. Set the prefixes before you publish, or add redirects in SEO yourself. See Add a redirect.

2. Add authors

  1. Open Blog › Authors and select New Blog Authors.

    The empty Create Blog Authors drawer, with Name, Slug, Linked account, Email, a Photo upload area, Designation and Biography with language tabs, and Status.
  2. Fill in Name. Leave Slug empty to build it from the name.

  3. In Linked account, pick the person's account in your Laramin, or leave it empty for a guest author who has no account. Each account can be linked to one author only.

  4. Add a Photo, Designation and Biography if your website shows them. Email is for your team only and is never published.

  5. Leave Status on Active, then save.

You see Author created.

3. Add categories

  1. Open Blog › Categories and select New Blog Categories.

    The empty Create Blog Categories drawer, with Name, Slug, Parent category, Description, Icon, Colour, a Cover image upload area, Display order, and Status and Visibility set to Active and Public.
  2. Fill in Name. Leave Slug empty to build it from the name.

  3. To put the category inside another one, choose it in Parent category. Leave it empty for a top-level category.

  4. Optionally add a Description, Icon, Colour and Cover image for your website to use.

  5. In Display order, lower numbers come first within the same level.

  6. Leave Status on Active and Visibility on Public, then save.

You see Category created.

4. Add tags

  1. Open Blog › Tags and select New Blog Tags.

    The Create Blog Tags drawer, with Name and Description language tabs, Slug, a Colour picker and a required Status field, plus Cancel and Save at the bottom.
  2. Fill in Name, and optionally a Description and Colour. Leave Slug empty to build it from the name.

  3. Save. You see Tag created.

People with Create Tag can also add a tag by typing it into Tags on an article's form.

What happens next

  • Writers can now pick these when they write an article.
  • With more than one language turned on, translate category and tag names, and author biographies, so your website shows them in each language.
  • Inactive categories, tags and authors keep their articles, but your website no longer lists them. An inactive tag isn't offered on the article form either.
  • A category or author with articles can't be deleted: Laramin says Move or remove the 2 articles filed under this category first. or Reassign the 2 articles written by this author first. A category with sub-categories can't be deleted until they're moved. To delete or restore several at once, see Delete, restore and act on records in bulk.
  • A deleted category, tag or author keeps its slug, so an old link never starts pointing at something else.