Summary
Create a theme in the Airwallex web app to define your brand colours, logo, display name, and customer support links, then preview how it looks across invoices, payment links, and emails before applying it.
Before you begin
Log in to the Airwallex web app.
You need permission to create and edit themes (typically Owner, Admin, or Finance admin).
Step 1: Open the theme creator
Go to Settings in the left navigation.
Under Resources, select Themes.
Click + New theme.
Step 2: Enter theme details and appearance
Theme name (required)
Enter a name to help your team identify this theme internally.
This name is not shown to your customers.
Appearance
| Field | Required? | Notes |
| Display name | No | The business name shown to customers |
| Primary logo | No | PNG, JPG, or JPEG. Maximum 10 MB. Recommended: at least 200 px height, 4:1 aspect ratio |
| Square logo | No | PNG, JPG, or JPEG. Maximum 10 MB. Recommended: 200 × 200 px, 1:1 aspect ratio. If not provided, Airwallex uses a cropped version of your primary logo |
| Brand colour | No | Used as the main button colour across your touchpoints |
| Background colour | No | Page background on customer-facing pages |
| Text colour | No | Headings and key text on customer-facing pages |
Customer support
| Field | Required? | Notes |
| Website URL | No | Your company website |
| Help centre URL | No | Your customer help or support site |
| Terms & conditions URL | No | Defaults to Airwallex's terms if no URL is provided |
| Privacy policy URL | No | Defaults to Airwallex's privacy policy if no URL is provided |
| Customer support email | No | Must be a valid email address |
| Customer support phone | No | Must be a valid phone number in international format (for example, +61400000000) |
As you fill in fields, use the Preview panel on the right to see how your theme looks. You can:
Switch between preview types (for example, Digital Invoice, Payment Links, Customer Email)
Toggle between desktop and mobile views
The preview uses sample data and is for reference only. Actual payment methods shown to shoppers depend on currency and your active payment methods.
Click Next when you are ready to choose where to apply the theme.
Step 3: Choose where to apply the theme
On the Select where to apply the theme screen:
Billing
Applies to invoices, checkouts, and associated emails associated with the selected billing entities.
Select one or more Billing entities from the dropdown.
Payments
Applies to payment links, and associated emails associated with the selected payment accounts.
-
Select one or more Payment accounts from the dropdown.
You can apply the theme to billing entities only, payment accounts only, or both. You can also skip this step and apply the theme later.
Click Create to save the theme, or Back to return to the previous step.
Tips
You only need to enter a Theme name to create a theme. All other fields are optional.
Colour values must be valid hex codes (for example, 8000FF). Three-digit codes (for example, #F00) are automatically expanded to six digits.
If you enter an invalid value (for example, a malformed URL or email), an error message appears and you cannot proceed until it is corrected.