# V4 Gamification widget layout

<figure><img src="https://77049817-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfS5hl0PiysHtKAKMsQTe%2Fuploads%2Fgit-blob-541998142ccb4bb9b3e062fd3d8c8b1563ee3a6e%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

**Reference image package for V4:**

{% embed url="<https://libs.smartico.ai/gf/widget_images_v4.zip>" %}

{% hint style="success" %}
You will need to provide the package with exactly the same names of files and sizes of the images.
{% endhint %}

{% hint style="warning" %}
**Note:** V4 layout does <mark style="color:red;">**NOT**</mark> support:

* Standalone mode of Inbox
  {% endhint %}

#### Step by Step reference Videos

We have created these videos for you explaining how the full process works from beginning (using the Figma template) to end (delivering the required documents for implementation):

{% hint style="info" %}
You can switch the audio to another language by clicking the 'Settings' icon ⚙️ on the video and selecting your preferred language.
{% endhint %}

1. **How to edit images?**

{% embed url="<https://vimeo.com/1133188795>" %}

\
2\. **How to edit Colors?**

{% embed url="<https://vimeo.com/1133538674>" %}

\
3\. **How to export from Figma Color Template?**

{% embed url="<https://vimeo.com/1133563929>" %}

\
4\. **Validating the Skin Package**

{% embed url="<https://vimeo.com/1135653727>" %}

5. **Saving a local copy of the Figma file**

{% embed url="<https://vimeo.com/1174428130>" %}

6. **Sharing the skin with the Smartico Team**

{% embed url="<https://vimeo.com/1173387746>" %}

#### **How to work with the Figma file**

* **Sections in the file**

<figure><img src="https://77049817-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfS5hl0PiysHtKAKMsQTe%2Fuploads%2Fgit-blob-d6caa6360f2a21a8f98d8c10f506fc1e8338c2a8%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

`1*` Editable Section - This is the only section you can edit\
`2*` Changing the Variables - explains where to find variables/styles\
`3*` Not mandatory in the skin - in case you would like to change the visuals for the leaderboard empty status please include this image when selecting the images for exporting from the “Editable section”\
`4*` Preview Section - Locked by default, shows how your changes will look<br>

* **Edit images**

1. Go to the Editable section

<figure><img src="https://77049817-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfS5hl0PiysHtKAKMsQTe%2Fuploads%2Fgit-blob-d607db9cd7bb4fe5e4d4ee895edbf9ed4c268f86%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

2. Use CMD/CTRL + click to select the image inside a component (it works similar to the direct selection tool from Illustrator)
3. Edit or replace the image inside the component (parent) - changes will show live in the Preview Section (children)
   1. ⚠️ By changing the images inside the components in this 'Editable section', you will also be able to see how they change inside the widget screens (in the 'Preview' Section).

<div><figure><img src="https://77049817-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfS5hl0PiysHtKAKMsQTe%2Fuploads%2Fgit-blob-de77301bacaf4950df96a60415a95b5ac3fb3f07%2Fimage-20250924-090559.png?alt=media" alt=""><figcaption></figcaption></figure> <figure><img src="https://77049817-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfS5hl0PiysHtKAKMsQTe%2Fuploads%2Fgit-blob-d903fe5d109df4dd50d8c9975b94dbfb966f7605%2Fimage-20250924-090609.png?alt=media" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}

* Use high-quality images or vectors to avoid pixelation

* If you want to keep Smartico’s default images, no changes are needed, but you will still need to provide us with the file
  {% endhint %}

* **Edit colors**

Colors can be updated in the Styles panel on the right sidebar in the Replace images section

<figure><img src="https://77049817-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfS5hl0PiysHtKAKMsQTe%2Fuploads%2Fgit-blob-9b939501e11678c02b13012a8814474eedbd16cc%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}
Overall please avoid:

* Detaching, swapping, or adding styles or components.
* Editing colors that are set as plain values (only styles can be edited).

Any of the actions described above might result on our team declining the changes you made and requesting you another delivery
{% endhint %}

* **Export images**

1. Select all components in the Replace images section (plus the component inside the “Not mandatory in the skin” section if you made changes in this one and would like to export it too)
2. Click Export in the right sidebar
3. Use default settings (1x PNG)
4. Click Export layers and save the images - all the components selected, setting them to 1x PNG, and then clicking on the “Export“ button

<figure><img src="https://77049817-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfS5hl0PiysHtKAKMsQTe%2Fuploads%2Fgit-blob-508e222cb21016527fa2a7716c3636c18eb636f2%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

* **Validate the components exported**

1. Go to the Validator tool:<https://expo.smartico.ai/validate>
2. Choose a version (V3 or V4) - in this case V4
3. Upload your exported image folder
4. Check that all files and sizes are correct, this is the message you should expect:

<figure><img src="https://77049817-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfS5hl0PiysHtKAKMsQTe%2Fuploads%2Fgit-blob-1ec4bf836212f617cf6ce816031a5a72f6fe3ba1%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

* **Sharing with the Smartico Team**

1. Please save locally the Figma you just created

<figure><img src="https://77049817-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfS5hl0PiysHtKAKMsQTe%2Fuploads%2FC1t8eyXz0FWm8ozZ76DI%2Fimage-20260304-090313.png?alt=media&#x26;token=547da528-0730-4b80-99d9-2684321b5954" alt=""><figcaption></figcaption></figure>

2. After exporting, you will get a “.fig” file like this:

<figure><img src="https://77049817-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfS5hl0PiysHtKAKMsQTe%2Fuploads%2FCw1ZB1LiYdbN5miuh2ff%2Fimage-20260304-132009.png?alt=media&#x26;token=30224617-7148-4086-8d45-946f44cf0b03" alt=""><figcaption></figcaption></figure>

3. Open a Jira ticket and add the exported Figma inside
4. Attach archive with the package folder in the Jira ticket (if images should be changed, if not we will use the fall back icons, the ones you can see inside the template)
