---
url: /webapp.md
description: >-
  How to create and configure webapps (customer-facing websites), set URLs,
  languages, branding, and code requirements.
---

# Webapps

A **Webapp** is the customer-facing website where your audience places their orders. It's the storefront for your campaign — what customers see, interact with, and use to upload their photos and complete their orders.

## What is a Webapp?

When you create a campaign, customers need a place to participate. That's the webapp. Each webapp:

* Has its own URL (e.g., `yourcompany.stampix.com`)
* Can have custom branding (colors, fonts, shapes)
* Contains customizable content (text, images)
* Supports multiple languages
* Can be used by multiple campaigns

## Creating a Webapp

### Basic Setup

| Field           | Description                      | Example                   |
| --------------- | -------------------------------- | ------------------------- |
| **Name**        | Internal name for your reference | "Acme Summer Promo"       |
| **Key**         | Becomes your URL subdomain       | `acme` → acme.stampix.com |
| **Description** | Optional internal notes          | "Used for Q3 campaigns"   |

::: warning Important
The **Key** cannot be changed after creation. Choose carefully as this is your permanent URL.
:::

### Language Settings

Select which languages your customers can use. The webapp will:

* Show a language picker if multiple languages are selected
* Display all text and content in the customer's chosen language
* Send emails in the matching language

**Available languages include**: English, French, German, Dutch, Spanish, Italian, Portuguese, Polish, and more.

## Webapp Configuration

### Brand Configuration

After creating your webapp, connect it to your visual identity:

| Setting      | Description                                           |
| ------------ | ----------------------------------------------------- |
| **Branding** | Select a branding profile (colors, fonts, shapes)     |
| **Content**  | Select a content profile (text, images, translations) |

See [Branding](/branding) and [Content](/content) for how to create these.

### Privacy & Analytics

| Setting                   | Description                                                                            |
| ------------------------- | -------------------------------------------------------------------------------------- |
| **Privacy URL**           | Per-language link to your privacy policy (shown to customers in the selected language) |
| **Google Tag Manager ID** | Your GTM container ID for tracking (format: GTM-XXXXXXX)                               |

### Display Preferences

Control how your webapp behaves:

| Setting                | Description                             |
| ---------------------- | --------------------------------------- |
| **Languages**          | Which languages customers can select    |
| **Happiness Feedback** | How the feedback widget appears         |
| **Powered by Stampix** | Show or hide the Stampix attribution    |
| **Code Required**      | Whether customers need a code to access |

#### Happiness Feedback Options

The feedback widget lets customers share their experience with an emoji rating:

| Option            | Description                             |
| ----------------- | --------------------------------------- |
| **Icon and Text** | Shows emoji icons with descriptive text |
| **Icon only**     | Shows only the emoji icons              |
| **Disabled**      | No feedback widget shown                |

#### Code Required

When enabled:

* Customers must enter a valid code to start
* Only one campaign can be linked to the webapp
* You control exactly who can participate

When disabled:

* Anyone with the URL can place an order
* Multiple campaigns can share the webapp
* Use for open/public promotions

## Webapp Status

A webapp can be **Active** or **Inactive**:

| Status       | Effect                                  |
| ------------ | --------------------------------------- |
| **Active**   | Customers can access and use the webapp |
| **Inactive** | Webapp shows an "unavailable" message   |

::: tip
Deactivating a webapp immediately prevents new orders. Existing in-progress orders may be affected.
:::

## Campaigns Connection

A webapp can be connected to one or more campaigns:

### Single Campaign Setup

* One webapp → One campaign
* Usually used with "Code Required" enabled
* Simpler to manage

### Multiple Campaigns Setup

* One webapp → Multiple campaigns
* Usually used with "Code Required" disabled
* Campaigns distinguished by codes
* Useful when campaigns share the same branding

## Testing Your Webapp

### Preview During Setup

1. Open your webapp configuration
2. Click **Open in new tab** to view the live site
3. Check how it looks across different scenarios

### Using Demo Mode

From your campaign page:

1. Click **Visit Demo** or **Copy demo link**
2. This opens the webapp with a pre-filled test code
3. Complete a test order to verify the entire flow

## Best Practices

### URL Key Selection

* Keep it short and memorable
* Use your brand name when possible
* Avoid special characters or spaces
* Consider future campaigns (don't make it too specific)

Good examples: `acme`, `cocacola-rewards`, `nike2024`
Bad examples: `summer-promo-july-2024-free-prints` (too specific)

### Language Configuration

* Only enable languages you can support
* Ensure your content is translated for each language
* Consider your audience's primary languages

### Before Going Live

1. **Test on mobile** — Most customers use phones
2. **Verify all text** — Check translations and content
3. **Check the flow** — Upload photos, complete an order
4. **Review emails** — Check how order confirmations look
5. **Test codes** — Verify codes work (if required)

## Common Questions

### Can I change the webapp URL?

No, the key/URL is permanent. You would need to create a new webapp with a different key.

### Can multiple campaigns use one webapp?

Yes, as long as "Code Required" is disabled. Campaigns are distinguished by their codes.

### What happens if I deactivate a webapp?

The URL will show an "unavailable" message. No new orders can be placed. This takes effect immediately.

### Can I delete a webapp?

Webapps with order history should not be deleted. You can deactivate them instead.

## Related Topics

* [Branding](/branding) — Customize colors, fonts, and visual elements
* [Content](/content) — Manage text and images
* [Campaigns](/campaign) — Connect your webapp to campaigns
* [Codes](/codes) — Create access codes