Get step-by-step Smart-IT eCommerce training. Learn how to optimise your Smart-IT to get the most out of your web shop.

Smart-IT eCommerce training

Get step-by-step Smart-IT eCommerce training. Learn how to optimise your Smart-IT to get the most out of your web shop.

Guides

Item Name

Item Name is used in your Product Archive / Search Pages.

You want to keep it short but descriptive, as this is the first description a customer will see. 

 

The character limit for this field is 255 Characters.

Item Short Description

This description will appear on the Product Single View Page.

It gives a longer summary of what the product is about.

 

The character limit of this field is 500 characters.

Item Long Description / Memo

This is used to give as much information as possible about the product.

Be careful of using this, especially when copying data from another website.

As most data from other websites are contained within HTML you are copying that HTML code over without realising it.

This could hurt both consistency on your site how this description is rendered (and even in some cases break your themes layout altogether) as well as your SEO score if the wrong Tags are used. (Especially in cases where H1, H2 or H3 tags are used)

You can also input images here but I highly discourage this.

 

If you are unsure the best course of action will always be the click on the "Show Source" button and then paste your data as this will paste it without HTML formatting (If you copied what looked to you like text only)

You can then click on that button again and modify the line breaks, bulleting etc.

Tags for WooCommerce

When it comes to SEO and accessibility best practices for a WooCommerce single product page, using proper HTML heading tags (<h1>, <h2>, etc.) is important for both user experience and search engine crawling.

Here's a breakdown of how heading tags should ideally be structured on a single product page in WooCommerce:

Recommended H Tag Structure for Single Product Page:

h1 Product Title

  • Purpose: This should be the only <h1> on the page and should contain the product's name.
  • Example:

<h1 class="product_title entry-title">Awesome T-Shirt</h1>

h2 Section Headings (Main content areas)

  • Used for:
    • Product summary or description
    • Additional Information
    • Reviews
  • These should all be at the same hierarchy level.
  • Examples:

<h2>Description</h2> <h2>Additional Information</h2> <h2>Reviews</h2>

h3 Sub-sections inside those sections

  • Inside description or review tabs, if there are sub-sections (e.g. materials, size guide, etc.), use <h3>.
  • Example:

<h3>Material & Care</h3> <h3>Size Guide</h3>

h4 and below — Only if needed

  • Deeper content nesting, such as points within tabs, FAQ sections, or in detailed review breakdowns.

Bonus Tips

  • Don't skip levels (like jumping from <h1> to <h4>).
  • Avoid using heading tags for styling alone (use CSS classes instead).
  • Make sure there is only one <h1> on the page for SEO clarity.
  • Use consistent heading structure site-wide for a strong SEO foundation.

WooCommerce Default Behavior

Out of the box, WooCommerce usually wraps the product title in <h1>, and the description/review tabs are often in <h2> or <h3>, depending on the theme. But it’s theme-dependent, so always inspect the source or override templates if needed.

Attributes & Features

Terms

In Smart-IT we have Attributes (Which plays hand in hand with Web Combination Items) and we have Features.

WooCommerce only has attributes, so both the attributes and the Features from Smart-IT will pull into the attributes of WooCommerce.

Web Combination Items from Smart-IT will populate variations in WooCommerce.

When and how do I use these

Lets look at what each are in Smart-IT

Attribute

Specific properties assigned to a product, such as size and color in clothing, help customers filter and select products based on their preferences.

As mentioned earlier this goes hand in hand with Web Combination Items. I will explain later why.

Feature

Functionalities or specifications of a product that enhance its usability or appeal.

For example, a laptop might have features like battery life, processor speed, or screen resolution..

Features are used primarily for filters so we want to make conscious decisions in how many Features we load as you can only load so many filters.

The more Features you have and the more characters are used within the name and value of these filters, the slower your website response will be.

 

Features in Smart-IT

Add / Edit a Feature

To Create a New Feature.

Click on Edit/Add Feature.

Click on Add Feature Type in the name for the Feature for example Material.

Add Feature to the item

Click on Select and select out the Feature you want to add.

It will populate in the Feature table.

Add Feature to the item

If an existing value needs to be used click on the dropdown Value (Existing) next to the feature and select out the value

Alternatively if its a new value you want to add type it in the Value (Freehand/Add) field next to the feature.

Technical Details

Character Limits

  • Attribute Name:

    • WooCommerce Database limit: 200 characters (WooCommerce schema: name VARCHAR(200))

    • API sanitizes long names; best to stay under 100 characters for stability.

  • Attribute Values:

    • Each term name: 200 characters

    • Keep practical limit to 26 characters for searchability and UI usability

Please Note: These limitations are not imposed by Smart-IT but by WooCommerce.

 

Technically you can update the values in phpMyAdmin

phpMyAdmin table wp_terms 

Change structure and name and slug from varchar(200) to varchar(1000)

Please note any database update can possibly change this back and potentially break your site (Site might be down and say critical error in that case)

Also note this change will have a significant impact on performance

 Smart-IT does not take any responsibility if you perform the steps mentioned above

 

I am not a Smart-IT user / I use the limited sync option in Smart-IT

How do I add / edit product Attributes?

When you’re adding attributes for your products, there are two ways you can add them:

  • Attributes can be defined globally, so they’re easy to update across the entire store, and available to be used on any product, or;
  • Attributes can be defined individually, at the product level, and they will only exist for that single product.

 

Generally, it’s preferable to define attributes globally. Once global attributes are defined, they can be assigned to any products as needed. Global attributes make updates easier as well. Say your marketing team wants to start calling “Blue” products “Cerulean” instead. You just update the name once in the attributes page, and it’s updated everywhere that attribute was used.

Create global attributes

Adding global attributes sets them up so they can be applied to any product in your store. To add an attribute globally:

 

  • Navigate to Products > Attributes.
  • In the “Add new attribute” form, Add a Name.
  • Add a Slug; (optional); this is the URL-friendly version of the name.
  • Enable Archives if desired.

If enabled, you can view a page with all products having any term of this attribute. For example, if you have this enabled, and “black” is one of the options under the “colour” attribute, you can add http://yourstore.com/color/black/ to your menu to only display items with the “black” attribute.

  • Select a Default sort order. Choose between:
  • “Name”, (sort alphabetically)
  • “Name (numeric)”, (if the values are numbers)
    • If your terms are numbers – like shoe sizes for example – use this sorting order so numbers will be properly ordered.
  • “Term ID” or;
  • “Custom ordering” where you decide by dragging and dropping the terms in the list when configuring the terms (see below).
    • For variable products, the sorting order of the attributes affects the sorting order of the dropdown selector(s) on the product page.
  • Select Add Attribute.
Adding attribute options

Now your attribute is created, you’ll need to add terms aka. the options or values

 

  1. Once created, the attribute is added in the table on the right, but without values.
  2. Select “Configure terms” to add attribute values in the “Edit Attribute” page.
  3. On the “Edit Attribute” page, Fill the form with your attribute’s option’s details:
  4. Name – The name for this term.
  5. Slug (optional) – a URL-friendly version of the name, if you don’t enter one, a slug will be automatically generated based on the name you enter.
  6. Description – A description of the value. This isn’t displayed prominently by default, but some themes may show it.
  7. Next click Add New {Attribute name}, “Attribute name” automatically takes the name you gave the attribute when creating it. (e.g. “Add New Colour”)
  8. Add as many values as you wish. If you selected “Custom ordering” for the attribute’s sort order, reordering your values can be done here.
Add global attributes to product

After your attributes are created and their terms defined, you can add the created attributes to your products:

 

  • Go to: Products > Add Product (or edit an existing one).
  • Select the Attributes tab in the Product data metabox.
  • From the “Add Existing” dropdown menu, select the attribute you’ve previously created. For example, Colour.
  • After adding the attribute to the product, add the relevant values for the attribute:
  • You can select existing terms/values one by one by clicking in the. “Values” area.
  • Click “Select all” to load all existing values for this attribute to the product at once.
  • You can also use the “Create value” button to add new values to the global attribute. These new values will be saved for global reuse.

 

Note:

When adding attribute values to a product using the “Select all” button, they will be added in their sort order. See above for details on the sort order options. The order values are added to the product here is the order they will be displayed on the front end of the site.

Add custom attributes

If you’ll only be using an attribute for one product, you can create and add it to that specific product from the “Attributes” tab on the “Edit Product” page. This would only be ideal if you have a product with unique variations. Attributes created on the product page are not available for global use.

To add a custom attribute to a single product:

  1. Go to: Product > Add Product.
  2. Select the Attributes tab in the Product data meta box.
  3. Click the “Add New” button, a new empty attribute will be added below.
  4. Give the attribute a name, and add values in the available box. Use the “pipe” symbol to separate values. |

In this way you can quickly add one-off attributes to products that have special characteristics.

Add custom attributes using the “Add New” button. These will only be added to this product, and will not be available for reuse on other products

Adding a Variable Product

Adding a variable product is similar to adding a simple product, but with a few more details to consider.

 

To add a new variable product:
  • Navigate to “Products” in WP-Admin (the site’s admin area).
  • Click Add New Product at the top of the page.
  • Enter the product name.
  • Choose “Variable Product” from the “Product data” dropdown menu.
  • Click on the “Attributes” tab on the left-hand side under the Product data dropdown.
  • Add either a global/existing attribute or create a new one (specific to the product):
Adding a Global Attribute:
  • If you’ve already created global attributes, select the one you want to use from the “add existing” dropdown menu at the top of the settings.
  • Select the variations/values you’d like to use from that attribute. You can add them all by clicking the “Select All” button below the values box or you can select specific ones you want to use by clicking on the “Select Values” box and selecting them one by one.

 

Adding a new Attribute:
  • Click the “Add New” button at the top of the settings.
  • Add a name for your attribute (examples: size)
  • Add the values (variations) you need. Separate each variation/value with | (i.e.: Medium | Large | XL | XXL)
  • Click “Save Attributes”.
  • Click on the Variations tab on the left.
  • Click either:
  • Generate variations to add all possible variations from all attributes values/variations.
  • Add manually to specify which variables will be available for the product.
  • Click on each variation to expand to its product menu.
  • Enter product information: Price, stock status, weight, dimensions, shipping class, and description. Add Linked Products if needed. Repeat for all variations.
  • Optional: Use the “Bulk Actions” dropdown at the top of the “Variations” menu to set product information for all variations at once.
  • Click Save changes at the bottom of the variations menu.

Click “Publish” in the top right of the screen to publish the product.

Each variation can have the following properties:

 

  • Image – Click the placeholder to add an image. See below

Recommended Resolution is 800 x 800 for Products.

  • SKU – Enter the SKU or leave blank. Note: If you set an SKU at the product level but leave it blank at the variation level, SKU will default to product level SKU.
  • GTIN, UPC, EAN, or ISBN – Enter a barcode or any other identifier unique to this product. This can help you list this product on other channels or marketplaces. This only accepts numbers and hyphens. Note: If you set a GTIN at the product level but leave it blank at the variation level, GTIN will default to the product level GTIN.
  • Enabled – Enable or disable the variation.
  • Regular Price (required) – Set the price for this variation. Variations without prices don’t show in your store.
  • Sale Price (optional) – Set a price for this variation when on sale.
  • Weight – Weight for the variation, leave this blank to use the main product’s weight.
  • Dimensions – Height, width and length for the variation, leave this blank to use the main product’s dimensions.

Sorting Attributes and Variations for Variable Products

You can sort attributes and attribute values of variable products to change their display in the shop’s front end. In the admin view, you can also sort product variations for ease of management. The following sections cover how to sort and organize the various details of your variable products

 

Reordering Attributes and values (variations) for the Customer View:

You can reorder both attributes and their values (variations) for the customer or storefront view from the “Attributes” tab. Here is how to do it:

 

Reorder Attributes

 

In the customer’s view, the selection fields of a variable product display in the same order as you sort them in the admin area. To sort your product’s attributes:

 

  • Click on the “Attributes” tab.
  • Drag and drop the attributes into a preferred order.
  • Click “Save Attributes” at the bottom of the settings window.
  • Click “Publish” or “Update” in the top right of the screen to finish.

 

Reorder values (variations) of Custom Attributes (Product Specific):

 

When using custom attributes on a variable product, the values will appear in the product dropdown on the storefront in the same order that you enter them in the “values” field.

To reorder values of custom attributes:

 

  • Click on the “Attributes” tab.
  • Click “Edit” to expand the attribute containing the values that you want to reorder.
  • Remove/Delete the values in the attribute.
  • Re-enter the values in the order they should appear on the front end.
  • Click “Save Attributes” at the bottom of the settings window.
  • Click “Publish” or “Update” in the top right of the screen to finish.

 

Reorder values(variations) of Global Attributes:

 

Similar to custom attributes, global attribute values appear in the same order on the product page as they do in the “Values” field of the product’s data. When created global attributes assign a defined sorting order, which determines how they populate in the “Values” field.

 

To change the default sort order of a global attribute:

 

  • Navigate to Products > Attributes.
  • Click the “Edit” link for the attribute you’d like to change.
  • Select a new default sort order.

 

To reorder values of an attribute that has the “Custom Ordering” Default sort order:

 

  • Navigate to Products > Attributes
  • Click the “Configure Terms” link for the attribute you’d like to change
  • Drag and drop the values/options in the order they should appear on the store’s front end.
  • Changes save automatically.

 

Note: The product page utilizes the manually sorted order only if the attribute’s default sort order is set to “Custom Ordering.”

Product Images

Can be found on the Product, on the Picture and Memo Tab.

Use the Images button.

From here you can browse to an image on your PC, copy an image from your clipboard or even scan in an image.

You can add as many images as you want but remember the more images you add the more resources will be used to open this Product Page.

You can set the Order of the Image and even use the Description to describe the image (Used in WooCommerce as the Alt Image Tag)

The recommended resolution is 800 x 800 pixels, 72dpi and the image format recommended is jpg.

This will keep the images small and the viewing experience consistent.

Product Brands

Can be found under the Tab Stock Items, Extra, Tables, Brands.

If you previously used Brands within Smart-IT and do not see anything listed here use the Auto Create Brands Button to populate the Brands.

From here you Add or Edit a Brand .

Name would be the name of the brand.

Description would be the slogan of the brand or a description of the Brand. It is limited to 255 Characters.

Logo Image would be the brand logo.

The recommended resolution is 400 x 200 pixels, 72dpi and the image format recommended is jpg.

This will keep the images small and the viewing experience consistent.

The Items can be setup on the product page, under the Additional Info Tab using the Brand name Search button.

Alternatively you can use the Bulk Change Selected in Extended Item Lookup to apply a brand to multiple items.

Payfast

Payfast Bank Ledger Account

 

We need to setup Payfast as a Bank on our Ledger

Click on the Ledger Tab and then on the Account Setup Icon.

Click on Add New Main Account and type the following Information:

Description: Payfast

Account Type: Bank

Default VAT: Not Applicable

Allow Post: Ticked

Reconcilable: Ticked

 

The account is now ready to be used.

 

You can allocate payments 3 different ways

  • When transferring a Sales Order to an Invoice, Select Direct Bank /EFT option and Choose Payfast on the Bank Account Dropdown (This is in the Payment Screen)
  • On the Sales Order you can also already allocate the payment if desired. While the sales order is open click on the Extra dropdown menu and click on Customer Payment/Deposit. Again fill in the amount in the Direct Bank / EFT and choose Payfast under the Bank Account dropdown menu.
  • If you already processed the Invoice under account you can go to the Customer Tab and click on the Receive Payment icon. Choose the customer. Again fill in the amount in the Direct Bank / EFT and choose Payfast under the Bank Account dropdown menu.

Shopify

Menu Generation (From Smart-IT - Use with caution as this will delete your current menu!)

 

On Shopify go to

Apps and sales channels > Develop Apps

Choose the App Developed by Smart-IT

Click on the Configuration Tab

Click on the Edit button next top Admin API integration

 

 

Online Store navigation

View menus for display on the storefront

Tick write_online_store_navigation

Tick read_online_store_navigation

 

Click on the Save button

 

You should now be able to use the Generate Menu button on the Shopify module within Smart-IT.

WooCommerce Variable Items not correctly syncing

If a website is new there might have been issues when the developer initially setup the site.

This causes the variable items no pull in under its master but not correctly assigning to the desired attribute.

To fix the issue

  1. Delete all products on WooCommerce
  2. Delete all products in the WooCommerce Bin
  3. Go to the WooCommerce Menu and click on the Status Option
  4. Go to the Tools Tab
  5. You will see an Option "WooCommerce transients This tool will clear the product/shop transients cache." 
  6. Click on the Clear transients button next to it
  7. Wait for the process to finish.
  8. You will also see an option "Orphaned variations This tool will delete all variations which have no parent."
  9. Click on the Delete orphaned variations button.
  10. Wait for the process to finish.
  11. Go to Products, Attributes and delete all the attributes.
  12. Now do a full sync from Smart-IT and the variations should be corrected.
  13. If the problem persists it is caused by a plugin.
  14. Disable 1 plugin at a time and repeat steps 1 - 12 until you find the plugin that causes the issue.
  15. Please report to us the plugin that caused this behavior.

Smart-IT WooCommerce not correctly syncing

If a website is new there might have been issues when the developer initially setup the site.

 

To fix the issue

Check that you can access the following page (Replace YOURURL with your domain)

https://YOURURL/wp-json/wc/v3/settings/general

 

Example

https://woocommerce.smartaccounting.co.za/

would be

https://woocommerce.smartaccounting.co.za/wp-json/wc/v3/settings/general

 

If you get an error 443 error (as shown below) then your hosting provider needs to open the Port or make changes in the Firewall.

 

Not Found
The requested URL was not found on this server.
________________________________________
Apache Server at YOURURL Port 443

 

When you get an 401 error (as shown below) then you know you are on the right track and can retry Syncing from Smart-IT.

 

{"code":"woocommerce_rest_cannot_view","message":"Sorry, you cannot list resources.","data":{"status":401}}

Want even more guides?
Check out our Video Library!
Video Library

On this Page

menucross-circle