nopSolutions/nopCommerce · warning · NopException

{textRequiredLocale} (localized, formatted with languageName

Error message

{textRequiredLocale} (localized, formatted with languageName)

What it means

ValidateTitleAndTextAsync throws NopException when 'text' is null/empty AFTER stripping HTML tags via Regex.Replace(text, "<.*?>", string.Empty). So an entity whose description is only HTML with no text content, or genuinely empty, fails the check. The message is the localized textRequiredLocale formatted with languageName.

Source

Thrown at src/Libraries/Nop.Services/ArtificialIntelligence/ArtificialIntelligenceService.cs:281

    /// <param name="textRequiredLocale">Locale for raising an exception about the title field required</param>
    /// <param name="titleRequiredLocale">Locale for raising an exception about the text field required</param>
    /// <param name="title">Title for validate</param>
    /// <param name="text">Text for validate</param>
    /// <returns>
    /// A task that represents the asynchronous operation
    /// The task result contains the validated title and text
    /// </returns>
    public virtual async Task<(string title, string text)> ValidateTitleAndTextAsync(string languageName,
        string textRequiredLocale, string titleRequiredLocale, string title, string text)
    {
        if (string.IsNullOrEmpty(title))
            throw new NopException(string.Format(await _localizationService.GetResourceAsync(titleRequiredLocale), languageName));

        if (!string.IsNullOrEmpty(text))
            text = Regex.Replace(text, "<.*?>", string.Empty);

        if (string.IsNullOrEmpty(text))
            throw new NopException(string.Format(await _localizationService.GetResourceAsync(textRequiredLocale), languageName));

        return (title, text);
    }

    /// <summary>
    /// Create product description by artificial intelligence
    /// </summary>
    /// <param name="productName">Product name</param>
    /// <param name="keywords">Features and keywords</param>
    /// <param name="toneOfVoice">Tone of voice</param>
    /// <param name="instruction">Special instruction</param>
    /// <param name="customToneOfVoice">Custom tone of voice (applicable only for ToneOfVoiceType.Custom)</param>
    /// <param name="languageId">The language identifier</param>
    /// <returns>
    /// A task that represents the asynchronous operation
    /// The task result contains the generated product description
    /// </returns>
    public virtual async Task<string> CreateProductDescriptionAsync(string productName, string keywords, ToneOfVoiceType toneOfVoice, string instruction, string customToneOfVoice = null, int languageId = 0)

View on GitHub (pinned to 64bdf2ff08)

Solutions

1. Ensure the entity has meaningful text content (not only images/markup) in the target language before AI generation.
2. Pre-check the stripped text length client-side and warn the user to add body text.
3. If only media is present, add a caption/alt-derived text so the stripped value is non-empty.

Example fix

// before
var (t,k,d) = await _aiService.CreateMetaTagsAsync(entity, languageId); // throws if body empty

// after
var body = languageId == 0 ? entity.Description : await _localizationService.GetLocalizedAsync(entity, e => e.Description, languageId, false);
if (string.IsNullOrWhiteSpace(Regex.Replace(body ?? string.Empty, "<.*?>", string.Empty)))
    return; // ask user to add description text first

var body = languageId == 0
    ? entity.Description
    : await _localizationService.GetLocalizedAsync(entity, e => e.Description, languageId, false);
var stripped = Regex.Replace(body ?? string.Empty, "<.*?>", string.Empty);
if (string.IsNullOrWhiteSpace(stripped))
    // do not call AI meta generation; prompt user to add text content
    return;

static bool HasTextContent(string html)
    => !string.IsNullOrWhiteSpace(Regex.Replace(html ?? string.Empty, "<.*?>", string.Empty));

try { await _aiService.CreateMetaTagsAsync(entity, languageId); }
catch (NopException ex) { /* body missing/empty — prompt user to add description text */ }

When it happens

Trigger: AI meta/product generation where the entity's body/description is empty, or consists solely of markup/img tags that become empty after tag-stripping (e.g. '<img src=...>' with no text).

Common situations: A product with FullDescription containing only an image; a topic/blog post with empty body; localized description empty in the target language; description that is whitespace-only.

Related errors

• {titleRequiredLocale} (localized, formatted with languageNam
• Admin.Common.UploadFile
• Email is not valid.
• {httpResponse.ReasonPhrase}
• {e.Message}

AI-assisted analysis of nopSolutions/nopCommerce@64bdf2ff08 (2026-08-13). Data as JSON: /api/errors/8beb2464bc13c1e7. Report an issue: GitHub.