General

The General tab holds a widget’s basic settings. Each widget has its own settings, so if you want several widgets to behave the same, apply the same settings to each one.

1. Go to Widgets
2. Select the widget to modify. It opens on the General tab.

Some settings are grouped in cards. Click a card to unfold it. The preview on the right updates as you change settings, but nothing reaches your website until you click Save at the top of the page.

Which settings you see depends on the widget’s layout. API widgets have their own General tab, described below.

Widget Name

The name is only used inside Raffle, for example in the widget list. Change it in the Widget Name field.

Search and chat

• Enable Raffle Search shows a search field that returns the pages that best match the question.
• Enable Raffle Chat Assistant adds the chat assistant, which answers in a conversation.

Launcher widgets can use either one or both. With both on, visitors can switch between search and chat. One of them must stay on, so you can only turn one off while the other is on.

Pill widgets are always chat-only. Overlay and embedded widgets are search-only. If search or chat isn’t part of your plan, the toggle can’t be turned on; contact Raffle Support to add it.

Template

Template switches the widget’s layout between Launcher, Embedded, Overlay and Pill. See Widget types for what each one looks like. Switching to the pill turns chat on and search off. For embedded widgets, enter the Element selector: the CSS selector of the element on your page where the widget is placed, for example #target-element.

Top Questions

Top questions are suggestions visitors can click instead of typing, for example your most frequently asked questions or a campaign. They appear when the widget opens.

1. Click Edit on the Top Questions card
2. Type a question in each field. Click Add question for another one, up to five.
3. Drag the handle on the left to change the order, or click the bin icon to remove a question.
4. Click Submit, then Save at the top of the page

You can paste several questions at once, one per line, for example a column from a spreadsheet. Copy all copies the list, one question per line.

When chat is enabled, Show top questions in chat also lists them in the chat.

To decide which answer comes first for a question, see Re-rank, or send a list of questions and their target URLs to Raffle Support.

Visibility

By default the widget loads on every page where the Raffle script is installed. Unfold Visibility to limit that.

Restrict domain

Enter a domain in Restrict usage to domain, for example example.com. The widget then runs only on pages of exactly that domain. A leading www. is ignored, so example.com also covers www.example.com, but other subdomains, such as shop.example.com, don’t match.

Hide on subpages

Under Hide widget on pages, enter the path of each page where the widget shouldn’t appear, for example /about rather than https://example.com/about. If you paste a full URL, only its path is used. Click the plus to add another path.

Each path also hides the pages below it:

• /about hides the widget on /about and on its subpages, such as /about/team.
• It doesn’t hide pages that only start with the same letters, such as /about-us.
• A trailing slash makes no difference: /about/ works like /about.

Paths are case-sensitive and must start with /.

Hide on homepage

For launcher widgets, turn on Hide widget on landing page to hide the widget on your website’s homepage.

UI Language

Unfold UI Language and choose a language from the list. This changes only the widget’s labels and placeholders, not the answers. To change individual texts, use the Text tab.

The available languages are Chinese (Simplified), Danish, Dutch, English, Finnish, French, German, Icelandic, Italian, Japanese, Korean, Norwegian, Norwegian Bokmål, Norwegian Nynorsk, Polish and Swedish.

The chat answers in the language of the visitor’s first message, whatever the UI language is (see Chat).

Intro Banner

For launcher and pill widgets, the intro banner shows a prompt when a visitor hasn’t used the widget for a while.

• Enable Intro Banner turns it on. If search is enabled, submitting the banner starts a search; if only chat is enabled, it starts a chat. Once the visitor submits or closes it, the banner doesn’t come back until their next visit.
• Delay is the number of seconds of inactivity before the banner appears.
• Icon (launcher only) is shown next to the banner text.
• Disable on Mobile hides the banner on mobile devices.

GDPR Disclaimer

Shows a short privacy notice with the widget’s search field, for example asking visitors not to share personal information.

1. Unfold GDPR Disclaimer
2. Turn on Enable GDPR Message
3. Write the text in GDPR Disclaimer (up to 500 characters)

To link to your privacy policy instead, use Add a link on support page on the Support tab.

Open links in the same tab

Turn on Open links in the same tab to open links from the widget in the current browser tab instead of a new one.

API widgets

API widgets have no visual widget, so their General tab is different:

• Widget Name, as above
• MCP Configuration: a Widget Description that tells AI agents what the widget searches and when to use it. See MCP Server.

Account admins also see:

• Search configuration: the Search result limit, the number of answers the API returns (up to 100).
• Top Questions, as above.
• Raffle Summary: Multilingual Summary, Tone of Voice (Formal or Informal), Answer Willingness (Conservative or Progressive) and Limit Summary Context, which work like the Raffle Summary settings of the same names. Limit Summary Context is the number of search results the summary is based on.

See Create an API widget for how to set up and use an API widget.