Widget Setup

Configure the theme extension, customize labels, and style the gift message widget.

Adding the Theme Extension

Bessanora installs as a native Shopify theme extension, which means it integrates seamlessly with your store’s existing design.

1. Go to Online Store → Themes in your Shopify admin
2. Click Customize on your active theme
3. Navigate to a product page template
4. Click Add block → search for Bessanora Gift Message
5. Drag the block to your preferred position
6. Click Save

[Screenshot: Adding the Bessanora block in theme editor]

Positioning the Widget

The widget works best when placed:

• Below the Add to Cart button — Most common placement, feels natural in the purchase flow
• Above the Add to Cart button — Customers see it before committing to purchase
• In a collapsible section — Keeps the page clean while still offering the option

You can reposition the block at any time in the theme editor by dragging it.

Customizing Labels and Placeholder Text

From your Bessanora dashboard under Settings, you can customize:

• Widget title — The heading shown above the gift message form (default: “Add a Gift Message”)
• Button text — The AI generation button label (default: “Inspire Me”)
• Placeholder text — The text shown in the message textarea before the customer types

Configuring Dropdown Options

The widget includes three dropdown menus that help the AI generate relevant messages:

Occasions

Default options include Birthday, Anniversary, Wedding, Holiday, Thank You, Congratulations, and more. You can customize these from the Settings page.

Tones

Options like Heartfelt, Funny, Formal, Casual, and Poetic help set the mood of the generated message.

Relationships

From, To, Parent, Partner, Friend, Colleague — these help the AI understand the context.

Styling

The Bessanora widget is designed to inherit your theme’s typography and colors automatically. The widget uses your theme’s:

• Font family — Matches your store’s body font
• Text colors — Inherits from your theme’s color scheme
• Button styles — The “Inspire Me” button follows your theme’s button styling
• Border radius — Matches your theme’s border radius settings

No custom CSS is needed in most cases. The widget is designed to look native to your store.