# General settings

To access these settings

1. Log in to your claimr account.
2. Select the **Campaign** you want to apply settings to.
3. Navigate to the campaign's **Settings** section.
4. Select **General settings** from the settings menu.

## **General settings**

This section is where you'll set the basic parameters for your campaign.&#x20;

{% hint style="success" %}
**Pro tip:** Choose a name, logo, and icons that resonate with your target audience and align with your campaign's theme. This will help create a cohesive and engaging experience for your users.
{% endhint %}

<figure><img src="https://2111509621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBtEHhi1fQEriwxTxRejw%2Fuploads%2Ft8wnJPgCUAt06A3flAlK%2FScreenshot%202025-09-14%20at%2019.00.10.png?alt=media&#x26;token=cddece90-fae3-42e6-b724-1789e2d1dd1e" alt="" width="375"><figcaption><p>General settings section</p></figcaption></figure>

### Campaign ID

A unique, auto-generated identifier for internal reference. You won’t need to change or use this unless working with the API or internal tools.

### Campaign name

This is the name users will see. It should clearly reflect the theme or goal of your campaign. Keep it short, engaging, and specific. Just type it into the field.

### Campaign logo

Your campaign’s visual brand. This image appears prominently throughout the widget and admin panel. Click *Edit* to upload or update the logo.

### Description

A clear and appealing description helps users understand the campaign’s value. Explain the goals, rewards, and what users should do next. You can use the rich-text editor to apply styles, add links, and insert images. Keep it concise but inspiring — this is the first impression your campaign makes.

<figure><img src="https://2111509621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBtEHhi1fQEriwxTxRejw%2Fuploads%2FgDETBFSwa9TYEwf1oPtg%2FScreenshot%202025-06-24%20at%2000.36.00.png?alt=media&#x26;token=6ffe7ead-8b3e-4815-9ced-c0babf14bed6" alt="" width="375"><figcaption></figcaption></figure>

### Campaign description tags

Tags allow dynamic personalization of your description. When inserted, they’re automatically replaced with data relevant to each user, making the experience feel more custom and engaging.

<figure><img src="https://2111509621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBtEHhi1fQEriwxTxRejw%2Fuploads%2F8rKqzlJrJ0Rb93oAQa6p%2FScreenshot%202025-06-24%20at%2000.32.36.png?alt=media&#x26;token=aaf850f1-284e-446b-8c97-77e1234bf75e" alt="" width="375"><figcaption><p>Campaign description editor</p></figcaption></figure>

Too see all available tags, visit our [descriptions-creation-usage-tags](https://claimr-io.gitbook.io/claimr-help-center/descriptions-creation-usage-tags "mention")article.

{% hint style="info" %}
Make sure all tags are correctly formatted so they are recognized and processed by claimr.
{% endhint %}

### Animation type

Choose how your description appears in the widget. You can apply visual effects such as typing animation to add a bit of flair and draw attention. Just select an option from the dropdown.

### Collapse description

This toggle helps control visual clutter. When turned on, the description is shown in a compact view with a “Show more” link. When off, the full description is visible by default. Use this to keep your widget clean while still offering full campaign details.

### Policies

This field allows you to add a link to your company’s own Terms, Privacy Policy, or any other external documentation. When provided, claimr’s widget displays both the default claimr Terms and the custom policy link. This is useful for meeting internal compliance or offering campaign-specific terms to users.

## Points

This section is where you configure the reward system of your campaign. You can edit the default point type (e.g., XP) and create additional point types.

<figure><img src="https://2111509621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBtEHhi1fQEriwxTxRejw%2Fuploads%2FheedRU99Inq0Zjskv30C%2FScreenshot%202025-09-14%20at%2019.03.01.png?alt=media&#x26;token=27912654-3a78-4f00-a1ee-05eab098f6c1" alt="" width="375"><figcaption></figcaption></figure>

### Campaign points name

This is the name of the reward system you’re using. It could be “Points,” “XP,” “Tokens,” or anything else. Choose a term that fits your community’s voice. This label appears across all user-facing components.

### Campaign points format

Define how points are displayed (e.g., 10,000). Use a format that matches your campaign’s design and readability needs.

### Process points based on past events toggle

When enabled, this toggle automatically recalculates users’ point totals if you change the point value of a task after it’s already been completed. This is helpful when correcting task values or adjusting campaign dynamics.

For example, if a task was worth 100 points and you later reduce it to 50, claimr will recalculate and apply the new value retroactively.

### Points icon

An image that represents the reward system. Use something simple and memorable. Click Edit to upload or replace the icon.

### Initial points

The number of points each user receives immediately upon joining the campaign, before completing any tasks. This is useful for campaigns restarting in a new season or continuing from a previous phase — allowing you to preload users with some progress.

For example, setting this to 50 means every participant will automatically get 50 points added to their balance at the start.

### Additional points

You can create new point types alongside the default one. Click **Add Point** to add a new block with the following fields:

* Point ID – must be entered manually and uniquely identifies the point. This ID can be used for description tags. This tag will display the total balance of that specific point for the user.

  To find out more about tags, visit [descriptions-creation-usage-tags](https://claimr-io.gitbook.io/claimr-help-center/descriptions-creation-usage-tags "mention").
* Name – the display name of the new point.
* Image – upload an icon for the new point.

You can add as many additional points as needed.

### Completion logic

After you create new points, they become available in all relevant reward and reporting sections:

* Quests: in the *Completion* reward field, you can assign values for each configured point type.
* Tasks: in the *Completion* reward field, you can assign values for each configured point type.
* Activity: the activity table displays totals for all point types in separate columns (*Total: Point 1, Total: Point 2, etc.*).
* Export: exports include the new columns for each configured point type.
* Tournaments: when configuring a tournament, you can select which point type is used to build the leaderboard.

## **Constrains**

<figure><img src="https://2111509621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBtEHhi1fQEriwxTxRejw%2Fuploads%2F7FOxywCtxC7rrTXmmVyZ%2FScreenshot%202025-06-24%20at%2000.38.33.png?alt=media&#x26;token=009a2e75-0157-49eb-8f3e-6881f8e93d57" alt="" width="375"><figcaption><p>Time limits section</p></figcaption></figure>

### **Campaign is locked**&#x20;

Use this toggle to prevent users from participating in the campaign, even if it’s visible. This is helpful when preparing or finalizing content before launch.

### **Limit campaign time**

Set a campaign start and end time to control when participation opens and closes.

Enable the toggle for "Limit campaign time" and set specific start and end dates. The time format is 24-hour (e.g., 14:00), and all settings follow your local time zone.

{% hint style="success" %}
**Pro tip:** Set clear time limits to create a sense of urgency for your audience and drive more engagement.
{% endhint %}

## **Campaign flow**&#x20;

This section is where you design the path your users take through your campaign. Use the flow to guide your users through a well-structured experience, encouraging them to complete quests and earn rewards along the way.&#x20;

<figure><img src="https://2111509621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBtEHhi1fQEriwxTxRejw%2Fuploads%2FW9lCsmwiuyZUeYvIADBE%2FScreenshot%202025-06-24%20at%2000.41.11.png?alt=media&#x26;token=22c652dd-c8ef-4be2-8a06-1149f2df03c2" alt="" width="375"><figcaption></figcaption></figure>

* **Assign an Intro quest:** the first quest a user sees when joining
* **Select Highlighted quests:** quests you want to showcase, such as special challenges or limited-time rewards
* **Choose an Intro pop-up:** Optional messages or a complete onboarding flow to greet new users. You can find more about the settings in our [into-pop-up](https://claimr-io.gitbook.io/claimr-help-center/pop-ups/into-pop-up "mention") article.&#x20;

{% hint style="success" %}
**Pro tip:** The order of your quests in the campaign flow impacts the user experience. Arrange your quests in a logical progression, starting with the easiest or most enticing and gradually increasing in difficulty or complexity.&#x20;
{% endhint %}

## **Languages**&#x20;

Add languages to localize your campaign. The primary language is shown by default, and you can add others to reach more users.

<figure><img src="https://2111509621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBtEHhi1fQEriwxTxRejw%2Fuploads%2FaJPPJsukY8NKEQ07vaZh%2FScreenshot%202025-06-24%20at%2000.41.26.png?alt=media&#x26;token=aa5ed59a-08bc-47b9-bc54-112040469f99" alt="" width="375"><figcaption></figcaption></figure>

## **Integrations**&#x20;

Input a Telegram bot ID to link your campaign with a Telegram bot. This is optional and used in campaigns that feature [Telegram-based tasks.](https://claimr-io.gitbook.io/claimr-help-center/tasks/telegram-tasks)

<figure><img src="https://2111509621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBtEHhi1fQEriwxTxRejw%2Fuploads%2FywhfbFP4P1HpxqyjfJZN%2FScreenshot%202025-06-24%20at%2000.41.34.png?alt=media&#x26;token=bd779019-70b5-4c3f-8a83-377c59e352e4" alt="" width="375"><figcaption></figcaption></figure>

{% hint style="info" %}
Make sure your bot is set up correctly in Telegram before linking it here to avoid errors during campaign participation.
{% endhint %}

## **Block options**

Protect your campaign by managing access with advanced restrictions. This section lets you block disqualified users, specific IP addresses, and traffic from selected countries.

<figure><img src="https://2111509621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBtEHhi1fQEriwxTxRejw%2Fuploads%2FjgI875wOOZMWqcM7GQUj%2FScreenshot%202025-06-24%20at%2000.42.20.png?alt=media&#x26;token=3a93aa0e-1424-482c-8850-f2ba1b5c888c" alt="" width="375"><figcaption></figcaption></figure>

### **Block disqualified users**&#x20;

When enabled, this prevents users marked as disqualified (via referral settings or quest conditions) from accessing your campaign.

### **IP block list**&#x20;

Enter one or more IP addresses to block access from known malicious sources or bot farms.

### **Country limitations**&#x20;

Choose whether to block or allow access based on a user's country. Select specific countries to block or to allow exclusive access for targeted regions.

{% hint style="success" %}
Pro tip: Combine IP and country restrictions to safeguard your campaign from fraud and unwanted traffic while maintaining access for real users.
{% endhint %}

## **Widget notifications**

Customize the system messages your users see during interactions with the campaign widget.

<figure><img src="https://2111509621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBtEHhi1fQEriwxTxRejw%2Fuploads%2Fzf1qR3va6eJMUqcju471%2FScreenshot%202025-06-24%20at%2000.48.12.png?alt=media&#x26;token=820f5554-f316-475f-9a8b-129f593ce49c" alt="" width="375"><figcaption></figcaption></figure>

**Delay (Seconds)** Set how long a notification should stay visible.&#x20;

**Task complete** Shown when a task is successfully finished.&#x20;

**Task updated** Appears when task progress or status is refreshed.

**Task pending** Let users know when a task is processing or being reviewed.

**Task failed** Displayed when the user’s attempt fails. You can encourage retries here.

**Reward earned** Shown when the user earns points. You can use variables like `{reward}` to reflect the exact amount.

**Failed login / verification** Used to prompt users to try logging in or verifying again if it didn’t go through.

**Text copied** Confirmation that the copied action (like wallet or code) was successful.

{% hint style="success" %}
Pro tip: Make your notifications friendly and on-brand to keep the user experience consistent and delightful.
{% endhint %}

## Public API

Once you’ve updated your campaign settings, a Public API section will appear at the bottom of the page. This section allows you to generate a token that can be used to integrate your campaign with external systems.

<figure><img src="https://2111509621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBtEHhi1fQEriwxTxRejw%2Fuploads%2F27CJnp7F2UFqE4JNc5sO%2FScreenshot%202025-06-24%20at%2001.38.22.png?alt=media&#x26;token=af98faf5-e92a-448d-bac8-9619b42218c4" alt="" width="375"><figcaption></figcaption></figure>

To create the token, click “Generate token.” Once generated, the token will be displayed in a masked format for security reasons. You can click the eye icon to reveal it.&#x20;

<figure><img src="https://2111509621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBtEHhi1fQEriwxTxRejw%2Fuploads%2F6IpVvJgloWiigHtOpQFz%2FScreenshot%202025-06-24%20at%2001.38.39.png?alt=media&#x26;token=3a5dd94f-1f77-4ceb-a255-be0f9e9901f6" alt="" width="375"><figcaption></figcaption></figure>

By clicking “Revoke token” you immediately disable access for any system using it.
