> ## Documentation Index
> Fetch the complete documentation index at: https://docs.terminus.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Campaign URL Builder tutorial

> Build a complete marketing governance model end to end across eight short parts, turning campaign details into UTM-tagged, shortened, QR-coded links.

<Info>
  **Time:** 45 to 60 minutes total, across eight short parts.

  **Audience:** admins building a governance model for the first time.

  **What you'll build:** a marketing setup (twelve fields, five picklists, three taxonomies for Email, Social, and Ads) that turns campaign details into UTM-tagged, shortened, QR-coded campaign URLs.
</Info>

## Why follow this tutorial

Terminus Hub's data model has a few moving parts: a governance model holds fields and picklists, taxonomies group those fields into forms, workspaces hold the data people enter, and approved submissions become records. The fastest way to learn how they fit together is to build one example end to end. This tutorial does exactly that, in eight short parts, each building on the one before.

## What you'll build

By the end, submitting a campaign like "Black Friday 2026" produces values like these automatically:

```text theme={null}
campaign_name  = black_friday_2026
utm_campaign   = awareness-us-california-20261115-black_friday_2026
tagged_url     = https://shop.acme.example/deals?utm_medium=email&utm_source=newsletter&utm_campaign=awareness-us-california-20261115-black_friday_2026
short_url      = https://go.acme.example/aB3xK9q2
qr_code        = a QR code that points at short_url
```

You enter a name, a date, a destination, and a few dropdown choices. The model assembles the rest.

## The eight parts

<CardGroup cols={2}>
  <Card title="Part 1: What you'll build" icon="map" href="/tutorial/01-overview">
    The end-state architecture and the concepts you'll meet.
  </Card>

  <Card title="Part 2: Governance model" icon="box" href="/tutorial/02-governance-model">
    Create the container and its first workspace.
  </Card>

  <Card title="Part 3: Fields basics" icon="text-cursor-input" href="/tutorial/03-fields-basics">
    Text, Date, and URL fields.
  </Card>

  <Card title="Part 4: Static picklists" icon="list" href="/tutorial/04-static-picklists">
    The `Goals` picklist and its dropdown.
  </Card>

  <Card title="Part 5: Hierarchical picklists" icon="git-fork" href="/tutorial/05-hierarchical-picklists">
    Cascading Country and Region dropdowns.
  </Card>

  <Card title="Part 6: User-addable picklists" icon="list-plus" href="/tutorial/06-user-addable-picklists">
    UTM mediums and sources, new values, per-taxonomy filtering.
  </Card>

  <Card title="Part 7: Computed fields" icon="function-square" href="/tutorial/07-computed-fields">
    Concatenation, Tagged URL, Short URL, QR Code.
  </Card>

  <Card title="Part 8: Your first submission" icon="send" href="/tutorial/08-first-submission">
    Create the taxonomies, enter data, approve.
  </Card>
</CardGroup>

## Prerequisites

* Admin access on a Terminus Hub account where you can create a fresh governance model. Creating, renaming, and deleting governance models, fields, picklists, and taxonomies is admin only.
* No prior setup. You build everything from scratch.

## What's not covered

The tutorial keeps to the common case. These topics live in their own articles:

* [Automated picklists](/recipes/automated-picklist): picklists whose options come from another taxonomy's records instead of a manual list.
* [Short URL slug modes](/recipes/short-url-slug-modes): `auto_only`, `auto_editable` (used here), and `manual_only`.
* [Other computed fields](/recipes/other-computed-fields): Auto Number, Random, Constant, and Terminus ID.

## Ready?

Start with [Part 1: What you'll build](/tutorial/01-overview).