Select your language

Semantyca NM for Joomla Version 1.0

Chapter 15

Troubleshooting and FAQ

Common problems, frequent questions and how to get support.

Solutions to common problems and answers to frequent questions. If your question is not answered here, contact support.

Sending

Newsletters stay in the queue

  • Check Setup health on the dashboard and Scheduler last ran on the Queue. If the task is off, enable Semantyca: send newsletters in System → Scheduled Tasks.
  • On a quiet site the lazy scheduler rarely runs. Add the cron job described in Scheduler and command line, or keep the Queue tab open with Send from this browser tab while it is open switched on.
  • Check the sending window and Maximum per hour in Options → Sending. Outside the window, sending waits.
  • Make sure the newsletter is not Paused.

Messages fail

  1. Open Deliveries, filter by status Failed and read the error.
  2. Test your mail set-up: send a test from the review screen, or a test automatic e-mail. With Joomla mail settings, check System → Global Configuration → Server → Mail; with a dedicated SMTP server, check Options → Sender.
  3. When the cause is fixed, tick the failed messages and click Retry.

Newsletters land in spam

Work through the deliverability checklist: own-domain sender, SPF and DKIM, bounce handling, a working unsubscribe link and a sensible sending rate. The pre-send checks warn about free-mail senders and senders on another domain.

"No recipients" on the review screen

Choose at least one list with subscribed members on Audience & sender. Unconfirmed, unsubscribed, bounced and suppressed addresses never count as recipients.

"This newsletter has already been sent … and can no longer be changed"

Sent and sending newsletters are locked so the report always matches what people received. Use Duplicate to make a new version.

A newsletter cannot be deleted

A newsletter that is currently sending cannot be deleted. Pause or stop it on the Queue first.

Content

The preview shows "Template error"

The template code contains an EJS or JavaScript error, often an unclosed <% %> tag or a misspelt variable name. Open the template, check the code against its Fields and use the Preview tab to test.

The article picker shows no or too few articles

Only published articles from the last Look back (days) and from the categories in Only from categories are offered (Options → Articles). Increase the period or add categories if an article is missing; you can also search by article ID.

Check Options → Articles → Article links. If articles are displayed by another component, use Custom pattern. For e-mails sent by the scheduler or CLI, also check Options → Advanced → Public site URL.

I cannot edit a template's code

Editing template code requires the Edit template code permission. Ask a Super User to grant it in Options → Permissions.

Subscribers and statistics

Subscribers do not receive the confirmation e-mail

Use Send test on Automatic e-mails to check delivery. Ask the person to look in their spam folder. Unconfirmed sign-ups are deleted after the period set in Options → Privacy; they can simply subscribe again.

Some addresses were not imported

Invalid, suppressed and erased addresses are never imported, and people who unsubscribed are not re-subscribed. The import summary shows how many were skipped for each reason.

Open rates seem low or high

With tracking Only with consent (EU), rates are calculated on recipients who allowed tracking. Mail clients that block images hide opens; privacy features such as Apple Mail's load images automatically and are reported as automated opens, which are not counted. Clicks are the more reliable measure.

Bounces are not processed

Click Test connection on the Bounces screen. Check server, port, encryption and login in Options → Bounces, and that the task Semantyca: process bounces is enabled. With VERP on, the mailbox must accept plus-addressing.

Frequently asked questions

Do I need a licence key for Semantyca to work?
No. Every feature works without a key. The key gives you updates and support.
Do newsletters have to be built from articles?
No. Templates can hold any bespoke content, and Freeform mode needs no template at all. Article-based and bespoke content can also be combined in one template.
Can I send the same newsletter again?
Yes: duplicate it and send the copy, for example to another list. Each copy has its own report.
Will people receive a newsletter twice if they are on two of the chosen lists?
No. Everyone receives a newsletter once, however many of its lists they are on.
Can I use Semantyca for an intranet?
Yes. Connect a list to Joomla user groups with Include user groups; every active user in those groups receives the newsletter and can still opt out.
Can I move from AcyMailing?
Yes, directly when AcyMailing runs on the same site, including lists, opt-outs and proof of consent. See Import from AcyMailing.
Does Semantyca work with my site template?
Front-end pages and the module use Joomla's standard markup and Bootstrap classes, and the bundled stylesheet never overrides your template. See Styling and overrides.

Getting support

With an active licence, open a support request through My account → Support on absolute.lv. Include your Joomla and Semantyca versions, what you did, what you expected and any error message. A screenshot of the dashboard's Setup health panel often helps.

Last updated 16 November 2026