> For the complete documentation index, see [llms.txt](https://subscriptions-docs.tech-arms.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://subscriptions-docs.tech-arms.io/features/customization/create-your-special-templates.md).

# Create your Special Templates

Give your subscription widget a premium design: pick a special template and a color, set its products and text, then save and publish.

**Special templates** are premium widget designs. Each one has its own layout and a set of brand colors, so your subscription offer stands out on the product page without any coding.

How special templates differ from the Default and Grid templates:

|                             | Default and Grid templates       | Special templates                                                                   |
| --------------------------- | -------------------------------- | ----------------------------------------------------------------------------------- |
| Design                      | You build it block by block.     | Ready-made layout. You pick a color.                                                |
| Change the text             | Edit each block.                 | Edit the **Custom Content** field.                                                  |
| Style                       | Style presets and **Custom CSS** | **Widget Color** and **Custom CSS**                                                 |
| Translate with **Localize** | Yes                              | No                                                                                  |
| Plan                        | Every plan                       | May need to be unlocked. See [Unlock special templates](#unlock-special-templates). |

## Create a special widget

{% stepper %}
{% step %}

### Open Special templates

In the app menu, click **Widgets**, then click **Create Widget** (or **Create new widget** if you have no widgets yet). On the **Special templates** card, click **Choose your template**.

![The Create new widget window with the Choose your template button on the Special templates card](https://3752025337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F479XnzvtVA5dDE3Rt2Uh%2Fuploads%2F8yvgOVonSprE4OHiglJq%2Fspecial-choose-card.png?alt=media)
{% endstep %}

{% step %}

### Pick a template and a color

The **Special Templates** panel lists the designs. Click a design to load it in the preview, or click one of its color dots to load it in that color. The selected design has a colored border.

To see the design with your own product, click the edit icon (**Edit Product**) next to **Preview** and pick a product or variant.

Use the mobile and desktop icons, and the **Media** menu (**Small**, **Medium**, **Large**), to check the design at different screen widths.

![The Special Templates panel with template cards and color dots, and the live preview](https://3752025337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F479XnzvtVA5dDE3Rt2Uh%2Fuploads%2Fi81jYh1f23bFoRWE3Zmb%2Fspecial-template-list.png?alt=media)
{% endstep %}

{% step %}

### Customize the widget

Click the gear icon (**Widget Settings**) in the top bar. The gear is available after you pick a template. Change the settings described below.
{% endstep %}

{% step %}

### Activate and save

Click **More actions** next to the widget name, then **Activate**. Click **Save** in the bar at the top of the editor.
{% endstep %}

{% step %}

### Publish

Click **Publish** at the top of the editor, then **Publish** in the **Publish widget** dialog. Changes can take 1 to 3 minutes to appear on your storefront.

If your plan doesn't include special templates, the **Unlock Special Widgets** dialog opens instead. See below.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
Saving doesn't change your storefront. After each change, click **Publish**. A widget that is **Deactive** when you publish it is removed from your storefront.
{% endhint %}

## Widget Settings

![The special widget settings with General, Apply to resources, Custom Styles, and Custom Content](https://3752025337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F479XnzvtVA5dDE3Rt2Uh%2Fuploads%2FqL4OJsaGsZOoOQ6zqtea%2Fspecial-settings.png?alt=media)

| Section                | Setting                                                                     | What it does                                                                                                     |
| ---------------------- | --------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| **General**            | **Widget name**                                                             | The name in your widget list. Customers don't see it.                                                            |
| **General**            | **Subscription option selected by default?**                                | When ticked, the product page opens with the first subscription plan selected instead of the one-time purchase.  |
| **Apply to resources** | **Priority**                                                                | 0 to 100. A new special widget starts at 10. When several widgets apply to one product, the highest number wins. |
| **Apply to resources** | **All**, **Specific products**, **Specific collections**, **Specific tags** | Which products use this widget.                                                                                  |
| **Custom Styles**      | **Widget Color**                                                            | The main color of the design.                                                                                    |
| **Custom Styles**      | CSS box                                                                     | Your own styles for the whole widget.                                                                            |
| **Custom Content**     | Text box                                                                    | The text shown in the widget, such as titles, labels, and benefit lines.                                         |

### Change the text with Custom Content

**Custom Content** lists each text of the widget on its own line, for example `"sub_form.custom_template.settings.subtitle.label": "Billed and shipped every month"`. The part before the colon tells the app where the text goes. Change only the text in the quotes after the colon. The preview updates as you type.

![The Custom Content box with the widget text](https://3752025337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F479XnzvtVA5dDE3Rt2Uh%2Fuploads%2Fyv1B3XvYXe9BlbXGEsQ3%2Fspecial-custom-content.png?alt=media)

{% hint style="info" %}
Keep the quotes, colons, commas, and braces as they are. If an edit would break this format, the box doesn't accept it.
{% endhint %}

You can also click **Customize Content** on the banner above the preview, which appears after you pick a template.

## Unlock special templates

You can create, customize, and save a special widget on any plan. Publishing it depends on your app plan. If special templates aren't included, clicking **Publish** opens the **Unlock Special Widgets** dialog.

Click **Contact Us** in the dialog. A chat with our team opens, and we'll help you unlock special templates.

## Good to know

* Special widgets count toward the limit of 10 widgets per store.
* In the widget list, special widgets appear at the end, under **Special widgets**.
* Special templates have no **Localize** button. Their text stays as you type it in **Custom Content** for every language.
* You can switch to another design at any time from the **Templates** panel. Click **Save** and **Publish** to apply it.
* For how the app chooses between widgets, see [Widgets](https://subscriptions-docs.tech-arms.io/features/customization.md).

*If you need help, feel free to reach out to us via in-app* [***Live chat***](https://go.crisp.chat/chat/embed/?website_id=c4ae10a3-f762-4968-b35a-c931caf62a96)***,*** [***Book a call***](https://calendly.com/ta-subscription-app-support/30min) *or at* [***support@tech-arms.io***](mailto:support@tech-arms.io)***.***


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://subscriptions-docs.tech-arms.io/features/customization/create-your-special-templates.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
