How to Fix Midjourney –cref (Character Reference) Not Working

Introduction

When your midjourney –cref character reference not working, the frustration is immediate. You add the –cref parameter with a reference image URL, expecting consistent character generation across prompts, but instead you get inconsistent results, error messages, or the character simply doesn’t look like the reference at all.

Character Reference (–cref) is one of Midjourney’s most powerful features for maintaining visual consistency across multiple generations. However, Midjourney has significantly changed how character references work—the –cref parameter has been replaced by Omni Reference (–oref) in Midjourney V7, and many users are unaware of this change. According to Midjourney’s documentation, Omni Reference “replaces Character Reference in V7” and can “duplicate much of the previous functionality of ‘character references’ in V6 but it’s also capable of much more.”[reference:0][reference:1]

This guide provides 10 proven methods to diagnose and fix midjourney –cref character reference not working issues on both V6 and V7, ensuring consistent character generation across your AI art projects.

For official guidance, Midjourney’s Omni Reference documentation provides detailed information on using –oref.

For broader AI tool troubleshooting, explore our AI Tools Errors hub which covers Midjourney, ChatGPT, Gemini, and more.

Why –cref Is Not Working

Understanding why midjourney –cref character reference not working occurs helps you choose the right solution. Several factors can prevent character references from functioning:

• Model version change in V7 – The primary reason is that Midjourney V7 replaced –cref with –oref (Omni Reference). According to Midjourney’s official Parameter List, Omni Reference “replaces Character Reference in V7.”[reference:2] If you’re using V7 with the old –cref syntax, the parameter will be ignored or cause errors.
• Feature removed in V8.1 – In Midjourney V8.1, character references, omni references, multi-prompting, and the quality parameter were removed entirely.[reference:3] If you’re on V8.1, you may need to use style references, personalization codes, or wait for the feature to be re-enabled.
• Incorrect parameter formatting – Parameters must be placed at the end of your prompt with a space before the dashes and no punctuation. According to Midjourney’s documentation, you should “place parameters at the end” and “watch the spaces.”[reference:4] Incorrect formatting can cause the reference to be ignored.
• Low-quality reference images – The precision of character reference is limited. As Midjourney founder David Holz noted, “The precision of this technique is limited, it won’t copy exact dimples/freckles/or t-shirt logos.”[reference:5] Low-resolution or mismatched reference images produce poor results.
• Stylize and Omni Weight conflicts – In V7, both –stylize and –exp compete for influence over the image with omni-reference. If you have a high stylize value, you must also use a higher corresponding omni-weight value.[reference:6]

Never assume your character consistency is permanently broken. Most cases of midjourney –cref character reference not working are fixable with the right approach.

Switch to Omni Reference (–oref) in V7

If you’re using Midjourney V7, the most important fix for midjourney –cref character reference not working is switching from –cref to –oref (Omni Reference).[reference:7]

On Discord:

1. Type your prompt as usual.
2. Add the Omni Reference parameter at the end: --oref url where the url directs to your reference image.[reference:8]
3. Example: a character in a cyberpunk city --oref https://example.com/character.png
4. Use the omni-weight parameter (--ow) to control how strictly it adheres to your image reference. The default is 100, with a range from 0 to 1000.[reference:9]

On the Web:

1. Open the Midjourney web interface.
2. Update your model version to V7 in the settings menu.[reference:10]
3. Drag an image into the prompt bar and drop it into the bin that says “Omni-reference”.
4. Use the slider icon to control the omni-weight strength.[reference:11]

Omni Reference can work for characters, objects, vehicles, or non-human creatures.[reference:12] It can “duplicate much of the previous functionality of ‘character references’ in V6 but it’s also capable of much more.”[reference:13]

Adjust Omni Weight (–ow) for Better Results

The omni-weight parameter (--ow) is critical for controlling how strictly Midjourney adheres to your reference image. Incorrect –ow values are a common cause of midjourney –cref character reference not working in V7.[reference:14]

1. Default (–ow 100): Use this for standard character consistency.
2. Lower weight (–ow 25): Use this if you want to change the style of the image (such as photo to anime).[reference:15]
3. Higher weight (–ow 400): Use this if you want to make sure that a character’s face is extremely visible or that their clothes are preserved.[reference:16]
4. Balance with stylize: Both –stylize and –exp compete for influence over the image with omni-reference. If you have a high stylize or exp value, you must also use a higher corresponding omni-weight value.[reference:17] Example: a person –stylize 1000 –-ow 400 --exp 100 –-oref person.png[reference:18]
5. Avoid excessive weights: Midjourney notes that “if you aren’t using extremely high stylize and exp you should probably never want go over ‘moderate’ values of ow like –ow 400 or things may actually be worse.”[reference:19]

Use the Web Interface for Omni Reference

The web interface provides a more visual and intuitive way to use Omni Reference, which can help resolve midjourney –cref character reference not working issues.

1. Log in to the Midjourney web interface at midjourney.com.
2. Ensure you’re using V7 in the model settings.
3. Drag your reference image directly into the prompt bar.
4. Drop it into the “Omni-reference” bin that appears.
5. Use the slider icon to adjust the omni-weight visually.[reference:20]
6. The web interface shows you the strength value in real time, making it easier to dial in the right amount.

This method is particularly useful if you’re having trouble with the Discord command syntax.

Check Model Version and Settings

Outdated or incorrect model versions are a leading cause of midjourney –cref character reference not working.

1. Check your version:
   • V6: Use --cref with --cw for character weight.
   • V7: Use --oref (Omni Reference) with --ow for omni weight. –cref is not supported in V7.[reference:21]
   • V8.1: Character references, omni references, multi-prompting, and the quality parameter are not available.[reference:22] You may need to use style references or personalization codes instead.
2. Update your settings: In the web interface, go to settings and ensure you’re on the correct model version. On Discord, use /settings to check and change your version.
3. Check for updates: Midjourney frequently updates its features. Check the Midjourney News & Updates page for the latest changes.

Some users have reported that V8.1 removed Omni Reference entirely. If you need character consistency, you may need to switch back to V7 or use other techniques like style references.[reference:23]

Use a High-Quality Reference Image

The quality of your reference image directly affects the consistency of your character. This is a critical factor in midjourney –cref character reference not working scenarios.

1. Use clear, front-facing images: The reference should show the character clearly, preferably with a front-facing or 3/4 view.
2. Include full-body references: If you want a consistent full-figure character, make sure the reference image shows the entire body, including feet and hands.[reference:24]
3. Avoid obstructions: Sunglasses, hats, or other accessories can confuse the reference system.[reference:25]
4. Use MJ-generated images: References created within Midjourney tend to work better than external photos.
5. High resolution: Higher resolution images provide more detail for the model to reference.

As Midjourney’s documentation notes, the character reference “works similarly to regular image prompts except it ‘focuses’ on the character trait.”[reference:26] A clear, focused reference yields better results.

Adjust Character Weight (–cw) for –cref (V6)

If you’re using Midjourney V6 and experiencing midjourney –cref character reference not working, adjusting the Character Weight (--cw) parameter can help.

1. The default Character Weight is 100, which preserves hair, clothing, and facial features as closely as possible.[reference:27]
2. –cw 0: Midjourney only copies the face, allowing you to change clothing, hairstyle, or setting.[reference:28]
3. –cw 50-80: A medium weight that balances face consistency with some style variation.
4. –cw 100: Maximum consistency—uses hair, clothing, and face exactly.[reference:29]
5. Example: a character in a forest --cref url --cw 50

If you want the original character in different clothing or settings, experiment with different –cw values.[reference:30]

Be Explicit in Your Prompt

Midjourney responds best to explicit instructions. Vague prompts can cause midjourney –cref character reference not working issues.

1. Describe what you want: If you want a character to hold a sword, say that explicitly: a character holding a sword --oref sword.png[reference:31]
2. Over-specify for low weights: If you have a low omni-weight, make sure to over-specify the parts of your character you want to preserve: anime woman with blonde hair and red suspenders --oref url --ow 25[reference:32]
3. Reference multiple characters: If you have two characters in your omni-reference image and refer to them both in your prompt, you can often get both characters in the resulting image.[reference:33]

Check for Server or System Issues

Sometimes midjourney –cref character reference not working is caused by server-side issues rather than user error.

1. Check the Midjourney Status Page for ongoing incidents.
2. Visit the Midjourney News & Updates page for recent announcements about feature changes or temporary disablements.[reference:34]
3. Check Discord channels like #support or #promptcraft for live help.[reference:35]
4. Wait and retry: If the service is temporarily down, wait a few minutes and try again.

Midjourney has acknowledged that “it does not always work as expected” and that “no guarantees are made as to the suitability of the Assets.”[reference:36]

Combine References for Better Results

For the best character consistency, combine Omni Reference with other Midjourney features.

1. Combine with Style Reference (–sref): Use –sref for visual style and –oref for character consistency.
2. Combine with Personalization: Omni-reference should work with personalization, stylization, style references, and moodboards.[reference:37]
3. Combine with Image Prompt: Use an image prompt alongside character reference for better results.

As one user noted, “Midjourney offers three types of image reference features: Character Reference (cref), Style Reference (sref), and Image Prompt.”[reference:38] Using all three can yield the most consistent results.

Contact Midjourney Support

If all else fails, contacting Midjourney support can help resolve midjourney –cref character reference not working issues specific to your account.

1. Visit the Midjourney Help Center for immediate assistance.[reference:39]
2. Join #support or #promptcraft on Discord for live help.[reference:40]
3. Email support@midjourney.com for account or billing issues.[reference:41]
4. Provide details about your prompt, version, and the specific error you’re encountering.

As Midjourney states, “We need your help to test this! And your feedback to know what you want us to improve.”[reference:42] Reporting issues helps improve the platform.

Advanced Technical Fixes

For expert users, these advanced methods go beyond standard procedures for midjourney –cref character reference not working.

Use the Seed Parameter

In V8.1, the seed parameter was reintroduced and “actually works this time.”[reference:43] Use --seed alongside other references for more consistent results.

Try Style References in V8.1

If you want consistent characters across prompts in V8.1, use style references, omni references (not yet in V8.1), or personalization codes.[reference:44]

Use SREF Code Fix for V7

If your SREF codes aren’t working in V7, you may need to update your prompts. Midjourney didn’t “break” SREF codes—they changed the system.[reference:45]

Try Omni Reference Collage Technique

For consistent full-figure characters, make sure your reference image shows the entire body clearly.[reference:46]

For additional AI tool support, see our guide on AI Tools Errors.

Conclusion

To fix midjourney –cref character reference not working, start by determining which version of Midjourney you’re using. If you’re on V7, switch from –cref to –oref (Omni Reference) and adjust the –ow (omni-weight) parameter. If you’re on V6, keep using –cref but experiment with –cw (character weight) values. If you’re on V8.1, be aware that character and omni references are not available—use style references or personalization codes instead.

The success of each method depends on the underlying cause—whether it’s a version mismatch, incorrect parameter formatting, low-quality reference image, or server-side issue. Typically, switching to –oref in V7 and adjusting –ow offer the highest success rate for midjourney –cref character reference not working.

If you encounter persistent issues, consider using the web interface for visual Omni Reference control, combining references for better results, or contacting Midjourney support. Regular updates and staying informed about Midjourney’s changing feature set are the best defenses against character consistency problems.

For additional AI tool support, explore our AI Tools Errors hub to address other Midjourney, ChatGPT, and Gemini issues.

Related Guides

• AI Tools Errors
• Midjourney Not Generating Images – 8 Proven Fixes
• Midjourney Subscription Required Error – 8 Solutions
• ChatGPT Deep Research Not Working – 2026 Guide
• Google Gemini Fact-Checking Overlay Not Working – 2026 Guide
• Adobe Firefly Generating Blank Images – 8 Solutions
• Speed Up AI Image Generation on Windows 11 – 8 Tips
• Top 10 Common ChatGPT Errors and How to Solve Them

Frequently Asked Questions

Why is –cref not working in Midjourney V7?

In Midjourney V7, –cref has been replaced by –oref (Omni Reference). According to Midjourney’s official Parameter List, Omni Reference “replaces Character Reference in V7.”[reference:47] Use --oref url instead of --cref url.

How do I use Omni Reference in Midjourney V7?

On Discord: --oref url with optional --ow for weight control. On the web: drag an image into the prompt bar and drop it into the Omni Reference bin. The default omni-weight is 100.[reference:48]

What is the difference between –cref and –oref?

–cref (Character Reference) was used in V6 for character consistency. –oref (Omni Reference) replaces it in V7 and can work for characters, objects, vehicles, or non-human creatures—not just characters.[reference:49][reference:50]

Does Omni Reference work with style references?

Yes. Omni-reference should work with personalization, stylization, style references, and moodboards.[reference:51]

How do I adjust the strength of Omni Reference?

Use the --ow (omni-weight) parameter. Default is 100, range is 0 to 1000. Lower weight (–ow 25) for style changes, higher weight (–ow 400) to preserve character details.[reference:52]

Does Midjourney V8.1 support character reference?

No. In V8.1, character references, omni references, multi-prompting, and the quality parameter were removed.[reference:53] Use style references or personalization codes instead.

What should I do if my character reference results are inconsistent?

Try adjusting the omni-weight (–ow) or character weight (–cw). Use a high-quality reference image, be explicit in your prompt, and combine with style references for better results.

Can I use Omni Reference for multiple characters?

Yes. If you have two characters in your omni-reference image and refer to them both in your prompt, you can often get both characters in the resulting image.[reference:54]

Why does my character’s face keep changing in Midjourney?

Character consistency is one of the hardest problems in AI art. The reliable fix is to give the model an actual identity to anchor to—a reference image or a trained identity layer, instead of asking it to improvise.[reference:55]

What should I do if none of the fixes work?

If all fixes fail, check the Midjourney status page for outages, join the #support channel on Discord for live help, or email support@midjourney.com.[reference:56]

Editorial Team