> For the complete documentation index, see [llms.txt](https://cth-development.gitbook.io/store-elements-for-tebex/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cth-development.gitbook.io/store-elements-for-tebex/getting-started/getting-started-with-store-elements-for-tebex.md). # Getting Started with Store Elements for Tebex Store Elements for Tebex lets you add Tebex-powered store elements to a Wix site, including package grids, package lists, package cards, search, basket buttons, gift buttons and product pages. This guide explains how to install the app, open the dashboard, start your trial and understand the first setup steps. ### Before you start You will need: * A Wix site where you can install and manage apps. * A Tebex webstore. * Access to your Tebex API keys. * An active trial or subscription for Store Elements for Tebex. {% hint style="info" %} Store Elements for Tebex uses Wix billing. Your 14-day free trial, subscription and renewal management are handled by Wix. {% endhint %} ### Install the app on your Wix site Install Store Elements for Tebex on the Wix site where you want to display your Tebex store. After installation, open your Wix site's dashboard and go to: **Dashboard > Apps > Store Elements for Tebex** The app dashboard is where you connect Tebex, manage billing, check the detected store type and contact support. ### Complete the welcome flow The first time you open the dashboard, you may see a welcome flow. This introduces the main parts of the app: 1. Store elements you can add to your Wix site. 2. How to find your Tebex API key details. 3. The 14-day free trial and plan options. ### Start your 14-day free trial Store Elements for Tebex must be activated before store elements can show packages or create baskets. In the dashboard's **Billing** section, choose a plan to start your 14-day free trial. Available options are: * **Monthly**: $9.99 per month after the trial. * **Annual**: $8.50 per month, billed annually. Both options include the same 14-day free trial. {% hint style="info" %} Wix opens billing checkout in a separate tab. After completing checkout, return to the app dashboard. The dashboard checks for billing updates automatically, so access should unlock shortly after you add your payment details. {% endhint %} ### Understand billing statuses The Billing card shows the current activation state for your Wix site. Common statuses include: * **Waiting...**: The dashboard is still checking the current subscription status. * **Not Activated**: This site does not currently have an active subscription. * **Trial Active**: The 14-day trial is active. * **Activated**: The site has an active paid subscription. * **Activation Ending**: Access is active now, but auto-renewal is not currently on. When the site is activated, the Billing card also shows the relevant trial end, renewal or access end date using `dd/mm/yyyy` format. {% hint style="warning" %} Each Wix app instance needs its own activation. If you install the app on another Wix site, that site needs its own trial or subscription. {% endhint %} ### Open subscription management When a trial or subscription is active, the dashboard shows a **Manage Subscription** link. Use this link to manage the subscription through Wix, including billing and renewal settings. ### Connect Tebex After activation, connect the app to your Tebex webstore. In the **Tebex Connection** card, enter: * **Public Token** * **Private Key** You can find these in Tebex here: Click **Connect Tebex**. If the connection succeeds, the dashboard confirms that your Tebex store was connected successfully. {% hint style="warning" %} Store elements will not show live Tebex packages or create baskets until both the Public Token and Private Key are connected. {% endhint %} ### Check the detected store The **Detected Store** card shows details about the Tebex store connected to this Wix site. This includes: * Store name. * Store type. * Customer login method. * Last validated date. The customer login method depends on the Tebex store type. For example: * Minecraft stores use Minecraft usernames. * FiveM and RedM stores use Cfx.re login. * Universal stores use no customer login. * Other supported auth-link store types are managed by Tebex. ### Product page URL format The **Site Settings** card shows the product page URL format: `/product/-` This is the format used when customers open individual package pages from supported store elements. At the moment, this field is shown for reference and cannot be edited. ### Add elements to your Wix site Once the app is activated and connected to Tebex, you can add Store Elements for Tebex widgets in the Wix Editor. Common elements include: * Basket Button * Package Grid * Package List * Package Card * Package Search * Add to Basket Button * Gift Button * Minecraft Head * Product Page Most elements include their own settings panel in the Wix Editor, where you can choose packages, categories, colours, fonts and layout options. {% hint style="info" %} If an element says setup is incomplete, open the app dashboard and confirm that billing is active and both Tebex API keys are connected. {% endhint %} ### Get support The dashboard includes a support form. You can use it to contact support directly from the app. The support card also shows your **Support ID**. Include this ID when asking for help, especially if you contact support outside the dashboard. You can optionally include app diagnostics with your support request. Diagnostics are designed to help troubleshoot setup and store connection issues without exposing your Tebex Private Key. --- # 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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://cth-development.gitbook.io/store-elements-for-tebex/getting-started/getting-started-with-store-elements-for-tebex.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.