Unicorn
Unicorn

FAQs

Getting Started

Now that you have installed Unicorn, what's next? 

Watch the video below to see instructions on how to get set up.


The article below will walk you through setting up Unicorn in your theme.

When you set up Unicorn for the first time, you will need to activate the Unicorn Core Script and add the Unicorn Cart Block to the header section of your theme

If you change your live theme, you will need to activate the Unicorn Core Script and Unicorn Cart Block again to continue displaying your carts.

Click here to automatically embed and activate the Unicorn Core Script on your theme.

To manually activate the Unicorn Core Script on your theme:

1. Inside your Shopify Themes menu, click "Customize" to open the Theme Editor: 



2. Click and open the “App embeds” side menu: 



3. Toggle on the “Unicorn Core Script”: 



4. Save your changes and head back to the Unicorn app.


Now that you have added the Unicorn Global Script to your theme, what's next?

The article below will walk you through adding the cart block to your theme.

This allows your Unicorn carts to be rendered in your store front.

To manually activate the Unicorn Cart Block on your theme:

1. Inside your Shopify Themes menu, click "Customize" to open the Theme Editor: 



2. Click "Add section" under the Header title. Then click the "Apps" tab. Then select the "Cart" block by Unicorn: 



3. Save your changes and head back to the Unicorn app.


If you are having issues add the app block to your theme please read out troubleshooting guide.

My theme does not allow me to add an app block to the header section.

Some older themes have not been setup to have the ability to add an app block to the header section. This can be fixed with a small change to your theme code. Watch the video below for detailed instructions


Follow the steps below:

  1. Go to the edit code section of your theme.
  2. Open the sections folder in your theme code and click 'Add a section'.
  3. In the popup box that appears, click the json button and then enter 'header-group' in the input field, then click save. This will create a new file for you called header-group.json.
  4. Open the new file and change the name value from "Group name" to "Header", then click the save button.
  5. Open you layout/theme.liquid file. Then find the line:
    1   {% section 'header' %}
  6. Directly below add a new line and with the following:
    1   {% sections 'header-group' %}
  7. Then save the file and head back to the theme editor. You will now see a section called 'Header' and you can add the app block to that section.


I get an error when adding an app block to my theme header section

Some themes have disabled the ability to add an app block to the header section of the theme. You will see an error that reads:

Section '1234567' is not supported in section groups

This can be fixed with a small change to your theme code. Watch the video below for detailed instructions:


Follow the steps below:

  1. Go to the edit code section of your theme.
  2. Open the sections folder in your theme code and the app.liquid file.
  3. Find the code below:
    1 "disabled_on": {
    2    "groups": ["header", "aside","footer"]
    3  }
  4. Delete the "header" item from the list.
  5. Then save the file and head back to the theme editor. You can now add the app block to that section.


If you require help fixed an error or need help change your theme code please get in contact with our support and they will assist.

Note: Shopify manages all app charges and billing cycles according to their policy here.

How am I charged for Unicorn?

Once you activate your plan, a charge will be created and will only be applied once your trial period has ended. Plans are set based on your Shopify payment plan (Basic / Shopify / Advanced)

  • Your Unicorn subscription is a 30-day subscription and will be billed at the beginning of each 30-day period. 
  • Your Shopify bill will include the Unicorn charge even though the billing period for Unicorn might be separate. You can find your Shopify invoice in your Shopify Billing settings



Activating your Unicorn plan

When you do not have an active Unicorn plan the following banner will be visible prompting you to activate your plan:


Click "Activate Plan" will take you to the billing page. You can also access the billing page by click "Settings" in the left hand menu, following by "View plan":



Once on the plans page, review your plan costs and free trial period, then click 'Activate plan'



After click 'Activate plan' you will be redirected to the Shopfiy App Subscription Approval page, where you can review the charges and then click 'Approve'. Once approved you will redirected back to the Unicorn billing page.




Brand styling can be set via the "Branding" page. Here, the styling settings below can all be adjusted to match your store's theme styling. 

  • Buttons
  • Inputs
  • Variant layouts
  • Variant name
  • Variant pills
  • Fonts

Buttons

Unicorn has the option to set both a 'primary' and 'secondary' styled button. when applicable  throughout the app there will then be option to select which styling of button to use.

Click on either the 'Primary' or 'Secondary' tab buttons to switch between the settings.


Buttons

Allows for the styling of text inputs and select inputs used throughout the app.


Variant Layout

This sets the layout of the product variant selectors with the following options: 

  • Grid - is fixed in the number of selectors per row and responds in a fixed manor to screen size changes. Selectors will appear evenly distributed and consistent in width. Great for small consistent selectors eg: S / M / L / XL
  • Flex - Selectors will fill the space with no fixed number of selectors per row. The width of each selector with match the content of the selector. Selectors will span across multiple rows and will change responsively to different screen size. Great for inconsistent selectors eg: Sit / Consectetur / Amet / Pellentesque

Variant Name

Allows for the variant name (label) used throughout the app to be styled

Variant Option

Allows for the variant option (selector) used throughout the app to be styled

Fonts

As a default, Unicorn is set to use the body font from your theme.

Unicorn will only reference fonts and will never load in any additional fonts of its own, as this will degrade performance. 

You can select your Heading and Body font from the dropdown list:




If you use a custom fount not found in the dropdown (Advanced)

Please contact support if you need help so this can be activated.

As every theme is different, it is advised to reach out to your theme developers to find out what fonts have been referenced in your theme css. 

If you are more technical, the font references can usually be found by right clicking on your website, clicking 'inspect elements', selecting the 'body' tag. Then in the 'Styles' tab, scroll down to the :root declaration to find the following values.

  • --font-heading-family
  • --font-body-family



Carts

Unicorn allows for the creation of multiple carts, each of which can target multiple markets.

A cart can be created from by click the 'Create cart' button on the cart index page.



You will then be directed to fill in the name and select the target markets before clicking the 'Save' button.



Once the cart has been saved you will directed to the cart building page with the default blocks already created.

A cart can be duplicated by click the 'Duplicate cart' icon button on the cart index page.




A cart can be deleted by click the 'Delete cart' icon button on the cart index page.




Select the cart you wish to update from the list of carts on the index page by clicking on the cart name.


Updating Core Settings

Here you can change the following settings:

  • Name
  • Status - Active | Draft | Archive
  • Markets
  • Set as default cart


Cart Statuses

A cart can have the following statuses:

  • Active - This cart is live on your store.
  • Draft - This cart is not live on your store but can be previewed in the online theme editor or on your shops front end.
  • Archived - This cart can not be previewed in the online theme editor or on your shops front end.


Markets

Each cart can be assigned to multiple markets. You can view/edit your markets within the Shopify Admin here and can read about Shopify Markets here.

To select which markets the cart is assigned to, click the Markets dropdown button and then click the checkbox of each market you wish to assign the cart to. 

If multiple live carts are assigned to the same market then the latest created cart for that market will be displayed to the customers.

By assigning carts to markets this allows you to display localized offers and content to your customers. Meaning you can achieve the following:

  • Show specific upsells, discounts and free gift offers to specific markets.
  • Create carts in different languages


Default Cart

If a customer visits from a market that has no cart assigned to then the 'default' cart will be displayed.

To change the default cart, click the "Set as default cart" checkbox then 'Save' the cart.


Preview a Cart

To preview a 'Draft' cart before publishing it, make any intended changes then click 'Save'. Once saved, the 'Preview' button will become active. Once clicked, the Front End of your store will open in a new tab and the Unicorn Preview Bar will be visible. 

You will then be able to interact wit your draft cart.

To exit 'Preview Mode' click the link: 'Click to exit'



Cart Styling

Here you are able to change the cart title, background colors, border colors and cart style with the cart styling section


Empty Cart

You can change the content of an empty cart by configuring the text displayed and the continue shopping button.


The content of a cart is built by adding content blocks to either the Header section, Main section or Footer section.

  • Header - Sticky section at the top of the cart drawer.
  • Main - scrollable mid section of the cart drawer.
  • Footer - Sticky section at the bottom of the cart drawer.

The following content blocks can currently be utilized and added to any section: 

  • Add to unlock
  • Banner
  • Checkout button
  • Cross sell
  • Discount codes
  • One tick upsell
  • Split payment
  • Terms
  • Text

To add a block to a section. Click the 'Add block' button at the base of the section you wish to add the block to, then select the block from the dropdown list.



Block can also be duplicated (using the duplicate icon button) and deleted (using the delete icon button). Once you make change, delete or duplicate a block, the cart will need to be saved in order for the changes to take effect. 


An Add to unlock cart block enables a progress bar to be added to the cart with rewards that a customer can unlock by spending more.

To style the progress bar use the following settings:

  • Progress bar thickness
  • Progress bar color
  • Progress bar background color
  • Reward size
  • Reward spacing
  • Reward background color
  • Completed reward background color
  • Reward tick color


Rewards can then be added to the progress bar by selecting "+ Add reward" button and then selecting the reward type from the dropdown menu. The options are:

  • Shipping - Display a free shipping threshold 
  • Discount - Add a discount code to the order
  • Buy X Get Y - Add a Buy X Get Y discount to the order
  • Free Gift - Add a free product to the order

A Maximum of 5 rewards can be added to any one progress bar.

A discount reward and a Buy X Get Y reward can not be added at the same time. This is a Shopify limitation which causes conflicts between the two discount codes. 


Shipping Rewards

Display a free shipping threshold for customers to reach. Find the shipping zones for the markets the cart has been assigned to (Settings > Shipping and delivery > zones). Set up the market with free shipping thresholds:



Add the free shipping threshold to the "Amount threshold" input field. Customize the Progress bar label.



Discount Rewards

Auto add a discount to the customers cart when a threshold has been met. Create a discount code within the Shopify Admin.

Click 'Discounts' in the Shopify Admin navigation. then Click 'Create Discount'. From the popup select 'Amount off products'



Fill out the discount form:


Once the discount code has been created. Head back to the Unicorn app and add the following details to the discount reward ensuring they match the discount code created.

  • Amount threshold - minimum purchase amount of the discount code
  • Discount code title - the name of the discount code created
  • Any items from - match the applies to field (Specific Collection / Specific Product)
  • Collections / Products - match the collections / products the discount code applies to
  • Progress bar label - This can be anything you wish
  • Discount type - match the type of the code - Percentage or Fixed Amount. 
  • Percentage off / Amount Off - match the discount code.

Due to how Shopify handles Fixed-Amount discounts we advise against using them for any multi currency stores unless you have set manual exchange rates. Read more


Buy X Get Y

Offer customers to get free gift incentive using a Buy X Get Y Shopify discount once the threshold has been met. Create a discount code within the Shopify Admin.

Click 'Discounts' in the Shopify Admin navigation. then Click 'Create Discount'. From the popup select 'Buy X Get Y'


Fill out the Buy X Get Y form:


Once the discount code has been created. Head back to the Unicorn app and add the following details to the discount reward ensuring they match the discount code created.

  • Amount threshold - minimum purchase amount of the discount code
  • Discount code title - the name of the discount code created
  • Any items from - match the applies to field (Specific Collection / Specific Product)
  • Collections / Products - match the collections / products the discount code applies to
  • Progress bar label - This can be anything you wish
  • Product - Match the free product to give the customer
  • Quantity
  • At a discounted value - match the discount code - Percentage / Amount off each / Free
  • Product description before item added to car
  • Product description after item added to cart
  • Product description if unable to add to cart
  • Product action - button text to add product to cart
  • Product background color
  • Product border color


Free Gift

Offer customers a free gift incentive once the threshold has been met. This is much more flexible than the Buy X Get Y gift and doesn't conflict with other discounts.

Create a product in the Shopify Admin and set the price to 0.

  • Amount threshold - minimum purchase amount of the discount code
  • Any items from - match the applies to field (Specific Collection / Specific Product)
  • Collections / Products - match the collections / products the discount code applies to
  • Progress bar label - This can be anything you wish
  • Product - The free product to give the customer
  • Quantity
  • At a discounted value - match the discount code - Percentage / Amount off each / Free
  • Product description before item added to car
  • Product description after item added to cart
  • Product description if unable to add to cart
  • Product action - button text to add product to cart
  • Product background color
  • Product border color


Account Information

If you've reached this page, there must be something we should be doing better!

If there's anything we can do to improve your experience with Unicorn, please contact our Support Team, and we'll get back to you as soon as possible!



How to Remove Unicorn and Stop Future Charges:

Pausing (or canceling) your Unicorn subscription can be done by visiting Settings > you plan. Then clicking "Cancel":



It can also be done by remove Unicorn from your Shopify apps menu:

 


Note: Uninstalling a third-party app can only be done by the store owner, and cannot be completed on our end.

When uninstalling Unicorn from your store, all your carts and settings will be saved, so if you choose to reinstall Unicorn, everything will be set as it was the day you left.

Note: To delete all of your data from Unicorn, please contact our Support Team.

Billing & Legal

Last updated: 17 October 2024

At Vibal Agency Pty Ltd, we respect and are committed to protecting the privacy of our users. This Privacy Policy describes how we collect, use, disclose, and safeguard your information when you use our Shopify app Unicorn. By using our app, you consent to the practices described in this policy.

1. Information We Collect

We collect the following types of information to operate and provide you with the best possible experience:

Shop Owner Data:

  • Personal Information: When you install Unicorn on your Shopify store, we collect personal information provided by Shopify, such as your:
    • Name
    • Email address
    • Store information (name, country, and timezone)
    • Contact details (email address for app-related communication)

Customer Data:

  • No personal data from your customers (such as their names, addresses, or payment information) is collected or stored by Unicorn.

Shopify Permissions (Scopes):

To access the necessary data from your Shopify store, Unicorn requests the following permissions:

  • read_checkouts
  • read_discounts
  • read_markets
  • read_merchant_managed_fulfillment_orders
  • read_orders
  • read_products
  • read_themes
  • write_merchant_managed_fulfillment_orders
  • write_orders
  • write_products

These permissions allow Unicorn to read and process data related to orders, discounts, markets, checkouts, products, and themes, enabling the app to provide its core functionality.

2. How We Use Your Information

We use the information collected for the following purposes:

  • App Functionality: The data collected allows Unicorn to perform its core functions, such as enhancing your Shopify cart experience, calculating conversion rates, and providing upsell recommendations based on order history.
  • Analytics: The data collected is used to generate insights and reports on cart performance, Average Order Value (AOV), and conversion rates to help optimize your store's sales.
  • Communication: We may use your email address to provide important updates about the app, respond to inquiries, or communicate about any changes to this privacy policy.

We do not use the collected data for marketing purposes, nor do we share any data for third-party advertising.

3. Data Sharing

Unicorn does not sell, rent, or share your information with third parties. All data collected is used solely for the purposes outlined in this privacy policy.

  • Service Providers: We do not engage third-party service providers to access or process your data. However, your data is stored securely in our own cloud infrastructure (see Section 4).

4. Data Storage and Security

We are committed to ensuring that your information is secure. To prevent unauthorized access or disclosure, we have implemented suitable physical, electronic, and managerial procedures to safeguard and secure the data we collect.

  • Data Location: All data is securely stored in a Google Cloud Platform (GCP) private database.
  • Encryption: Data is encrypted both in transit and at rest, ensuring that it remains protected from unauthorized access.
  • Access Controls: Only authorized personnel have access to the data, and all access is logged and monitored for security purposes.
  • Data Breach Notification: In the event of a data breach, we will notify affected users promptly and provide details on the nature and extent of the breach, as required by applicable laws.

5. Data Retention

We retain your information for as long as necessary to provide you with the services outlined in this policy, or as required by law.

  • Indefinite Retention: Unless a deletion request is made, we retain the collected data indefinitely to ensure continuous service and analytics for your store.
  • Deletion Requests: You may request the deletion of your data at any time by contacting us through our contact form. Upon receiving such a request, we will promptly delete your information from our systems, subject to any legal requirements for data retention.

6. User Rights and Choices

You have certain rights regarding the personal information we collect, particularly under GDPR and CCPA regulations:

  • Access: You may request access to the information we hold about you.
  • Correction: If any of your information is incorrect, you may request to have it updated.
  • Deletion: You may request that your personal data be deleted from our systems.
  • Data Portability: If you require a copy of your data in a portable format, we can provide it to you upon request.
  • Exercise of Rights: To exercise these rights, please contact us via our [contact form]. We will respond to your request in accordance with applicable laws and regulations.

7. Cookies and Tracking

Unicorn uses tracking technologies on our Shopify app listing page, including Google Analytics and Facebook tracking, to analyze visitor interactions and measure ad effectiveness. Additionally, we track customer actions such as clicks, page views, and conversions to provide store owners with insights and conversion rate analysis, helping optimize store performance.

These tracking tools gather anonymized data about user interactions without collecting personally identifiable information. Visitors to our Shopify app listing page have the option to opt out of certain tracking features as permitted by Shopify, and we encourage users to review Shopify’s privacy policy for details on managing their tracking preferences.

8. Compliance with Laws (GDPR, CCPA)

We take privacy seriously and comply with relevant privacy laws, including the General Data Protection Regulation (GDPR) and the California Consumer Privacy Act (CCPA):

  • GDPR Compliance: If you are located in the European Economic Area (EEA), we process your data based on legitimate interests to provide the functionality of Unicorn. You have the right to request access, correction, or deletion of your personal information at any time.
  • CCPA Compliance: If you are a California resident, you have the right to request the deletion of your personal information, opt-out of the sale of your personal data, and receive disclosures regarding your information. Although we do not sell personal data, we are committed to honoring all CCPA rights.

To exercise any of these rights, contact us using the contact form provided in the app.

9. Changes to This Privacy Policy

We may update this privacy policy from time to time to reflect changes in our practices or for other operational, legal, or regulatory reasons. We encourage you to periodically review this page for the latest information on our privacy practices.

10. Contact Us

If you have any questions, concerns, or requests regarding this privacy policy or the data we collect, please contact us here

We are committed to addressing any concerns or queries you may have in relation to your data and privacy.

Get support

Powered by