TryGhost/Ghost · warning

The URL must be in a format like https://www.instagram.com/y

Error message

The URL must be in a format like https://www.instagram.com/yourUsername

What it means

Thrown by the platform-validator engine for the Instagram definition when input is URL-shaped but can't be resolved to a valid instagram.com profile URL. Message declared in instagram.ts ('The URL must be in a format like https://www.instagram.com/yourUsername'); thrown in platform-validator.ts at: URL regex non-match (line 227 — wrong domain), no path-type match or empty remainder (line 233 — e.g. 'https://www.instagram.com/' with empty username), or built URL failing validator.isURL (line 263). The Instagram path type has an empty urlPrefix, so the username is the first path segment.

Source

Thrown at apps/admin/src/settings/app/utils/social-urls/instagram.ts:23

// underscores and periods, up to 30 characters, with no leading, trailing or
// consecutive periods. Threads reuses this rule — Threads accounts are
// Instagram accounts.
export const INSTAGRAM_USERNAME_RULE: UsernameRule = {
    extra: '._',
    min: 1,
    max: 30,
    notAtBoundary: '.',
    notConsecutive: '.'
};

const instagram = createPlatformValidator({
    domains: ['instagram.com'],
    www: true,
    pathTypes: [
        {urlPrefix: '', storagePrefix: '', rule: INSTAGRAM_USERNAME_RULE}
    ],
    errors: {
        invalidUrl: 'The URL must be in a format like https://www.instagram.com/yourUsername',
        invalidUsername: 'Your Username is not a valid Instagram Username'
    }
});

export const validateInstagramUrl = instagram.validate;
export const instagramHandleToUrl = instagram.handleToUrl;
export const instagramUrlToHandle = instagram.urlToHandle;

View on GitHub (pinned to 47d8b0e2ad)

Solutions

1. Use a profile URL like https://www.instagram.com/yourUsername or a bare handle (2–30 chars, allowed charset, no boundary/consecutive dots).
2. Confirm the domain is instagram.com.
3. Ensure the path after the domain isn't empty.
4. For non-throwing checks, use instagramUrlToHandle(url) which returns null on invalid input.

Example fix

// before — throws on wrong-domain or empty-path URL
const normalized = validateInstagramUrl(value);

// after — non-throwing pre-check, then validate
import {instagramUrlToHandle, validateInstagramUrl} from './instagram';
const trimmed = value.trim();
try {
    if (trimmed && trimmed.includes('://') && instagramUrlToHandle(trimmed) === null) {
        setFieldError('instagram', 'Use an instagram.com profile URL');
    } else {
        setNormalized(validateInstagramUrl(trimmed));
    }
} catch (e) {
    setFieldError('instagram', e instanceof Error ? e.message : 'Invalid Instagram URL');
}

// Non-throwing pre-check using the URL→handle extractor
import {instagramUrlToHandle} from './instagram';
function looksLikeInstagramUrl(input: string): boolean {
    if (!input || !input.includes('://')) return true;
    return instagramUrlToHandle(input) !== null;
}

null

try {
    const normalized = validateInstagramUrl(value.trim());
} catch (e) {
    setFieldError('instagram', e instanceof Error ? e.message : 'Invalid Instagram URL');
}

When it happens

Trigger: Input is URL-shaped but: the domain isn't instagram.com; the path after instagram.com/ is empty; a built canonical URL fails validator.isURL. Bare handles that fail the INSTAGRAM_USERNAME_RULE (charset/length/boundary) route to invalidUsername instead. Wrong-domain URLs (e.g. 'https://facebook.com/user') throw invalidUrl here.

Common situations: User pasted a URL for a different platform; user entered 'https://www.instagram.com' with no username; URL contains characters validator.isURL rejects; user pasted a reel/post URL (first segment is still taken as the profile, which may pass or fail the username rule).

Related errors

• Your Username is not a valid Instagram Username
• The URL must be in a format like @username@instance.tld or h
• Your Username is not a valid Mastodon Username
• The URL must be in a format like https://x.com/yourUsername
• Your Username is not a valid Twitter Username

AI-assisted analysis of TryGhost/Ghost@47d8b0e2ad (2026-08-13). Data as JSON: /api/errors/5b9ed6fe4f41b812. Report an issue: GitHub.