Help & Support

Your Cbox embed code is available at your control panel. You need this code to install your Cbox on your website.

Also on that page is your Quick Link — a URL which you can use to access your Cbox directly in your browser or on your mobile device.

Once you have created your Cbox account, go to the Publish page of your control panel. The code and steps for embedding your Cbox are provided there for a number of common platforms.

If you install your Cbox and all you see is code, or nothing at all, your web host may be removing or otherwise interfering with the HTML iframe tags that Cbox uses. Your Cbox code needs to be pasted into an area of your site that accepts HTML without modification. This may mean switching your editor from "rich text" or "WYSIWYG" mode into HTML-editing or "raw" mode, or you may need to open your template files in a plain-text editor like Notepad.

Remember that you always have the option of posting or sharing your Cbox Quick Link — this gives visitors direct access to your Cbox in a full-screen layout, so it's perfect as a mobile option or for stand-alone use.

Go to the Theme editor in your control panel. There you can specify the fonts and colours of your Cbox, using a point-and-click editor. You can always reset your theme to one of the preset defaults there, if you would like to start again.

If you have a Premium or Pro Cbox you can edit CSS, which gives you complete control over presentation.

If you have a Premium or Pro Cbox, you can create a moderator name for yourself at your Users page, and then log in on your Cbox using the "profile" link. You will see a delete icon [x] next to each message in your Cbox, and you will not have to log in at your control panel at all to delete messages.

Alternatively, visit your Messages page to delete messages individually or in bulk. Deleted messages are removed from your public Cbox history, but are preserved in your Archives.

Yes. In the Theme editor, simply delete the colour codes for the main and form background ("BG") elements. This will make the Cbox transparent, allowing whatever is behind the Cbox to show through.

Note that any pop-ups generated by a transparent Cbox will have the default background colour — usually white. If your font colour is light, it may be invisible in popups. You can fix this by editing the CSS to introduce a background-color rule for popups.

First decide whether the messages appear to be automated, or coming from an individual user.

Cbox works hard to prevent automated spam from reaching your Cbox. However if you are having trouble with such spam, you can require all users to solve a CAPTCHA before posting, by changing your CAPTCHA setting to "Strict" at your Settings page.

For spam from an individual user, first try banning the user. At your Messages page, select the unwanted messages and click "Ban". With a paid Cbox, you can ban the user from within your Cbox by logging in as a mod user.

Abusive users may attempt to evade bans by accessing your Cbox from behind an anonymizing proxy, via a VPN, Tor, or similar service. With a Pro Cbox, you can enable "Auto-ban proxies" at your Settings. You can also enable "Strong bans" there, which makes bans more resilient against changing IP addresses. However, it also increases the risk of bans affecting other users.

You can also strengthen individual bans by selecting them in your Blocked users list and clicking "Strengthen". This "widens the net" on an IP ban. Note that this can prevent other users of the same ISP from accessing your Cbox, so you should ensure the duration is short on such bans.

If you have a Premium or Pro Cbox, you have more access control options. It's recommended to always enable the option "Users must be registered to post". Normally, you would also enable "Users can password-protect their names" so that they can register themselves; for more control, you can disable this option and register users manually.

You can also choose to disable new registrations temporarily to "lock down" your Cbox. Existing users will still be able to log in and post.

Finally, if you disable the option "Users can password-protect their names" you can still enable "Users can authenticate via Facebook" — now new users can join your Cbox via Facebook, but if they are banned then their Facebook identity is also blocked.

Some other things you can do if you experience recurring abuse of your Cbox:

• Delegate moderator authority (Premium and Pro) to trusted users who are able to monitor your Cbox during times you are not.
• Use Moderated Chat mode (Pro) to prevent users posting directly to public chat. Their messages will need to be approved by a mod.
• Place your Cbox in a members-only or private area of your site, such that users must log in to your site before they can see your Cbox.
• Implement User Integration (Cbox Pro), which ensures that only users who are registered on your own site can post.
• Configure and enable the Site whitelist (Premium and Pro). This prevents your Cbox embed code from being displayed on any other site.
• Generate a new Security tag and republish your Cbox embed code. This revokes access for any user who may have a link to your Cbox but no longer has access to the page it is embedded on.
• Disable the Quick link. This will prevent users from being able to access your Cbox except via the page you have embedded it on.

Finally, if abuse continues, you should contact us. We want to keep all Cboxes free from spam and abuse, and will do what we can to assist.

Yes, you can have as many as you like! Create a separate account for each Cbox. You will need a unique account name for each, but we recommend using the same email address.

If you need a large number of Cboxes, you might want to be on our Cbox Pro plan. Cbox Pro supports channels, which are independent conversation threads. Each channel can be embedded or linked as if it were a separate Cbox, and will host a separate conversation. Channels share the same theme, settings and users, and you only need one control panel login to manage them.

Cbox supports private messaging to and from mod and admin users. You can enable PM for your Cbox at your Settings page.

You can also type out the PM command: enter //pm username message..., where username is the name of the person you want to send your message to. This method works if the username conforms to Cbox "strict name" or "ASCII name" policy, i.e. comprises alphanumeric characters only and includes no spaces. Otherwise, you will have to refer to the user by ID.

By default, ordinary users cannot send PMs to other ordinary users. One of the two participants in any private conversation must be a mod or admin.

Opting in and out

Registered users can opt in to sending and receiving private messages from other registered (non-mod) users, by entering //pm on. The command //pm off revokes this availability.

Errors on sending

Private messages can fail to send for a number of reasons. If you get an error, it will likely either be due to the target user not being online (see below) or due to policy regarding who can send and receive private messages (see above). If the target user is not online, you may need to wait just a few seconds before retrying. Refer to the onliners list to confirm whether Cbox recognizes the user as present.

Message delivery

Private messages are sent via the streaming interfaces. The target user must be viewing and connected. Users on old browsers or restricted networks may not be able to receive PMs. When your message has been accepted by our servers for relaying, you will see an indicator (by default, a tick symbol). When the message has been received by the target user, the indicator will change (double-tick symbol). If that doesn't happen, your message probably wasn't received. Note that Cbox does not know that a message has been read, only that it has been delivered.

Persistence

Cbox does not store private messages for future delivery. New messages are relayed only if the user has an active connection. If the user has gone offline or is otherwise unable to receive your message, it will not be sent again, and nor will it be seen by that user when he reconnects. If you do not see the two-tick "received" indicator within a few seconds of sending a message, you will need to re-send your message later.

You can generate message archives at your control panel. These are records of the conversation in your Cbox including messages that were subsequently deleted or purged.

The format is tab-separated CSV, so you will be able to import the file into a spreadsheet or database system.

It's not currently possible to import message archives back into Cbox.

You can set your preferred language at your control panel. This will change the language that your Cbox is displayed in, providing that we have a translation for that language. The Cbox website and control panel is only available in English.

If you would like to provide a translation for Cbox for your language, please contact us.